メインコンテンツへスキップ
すべてのシステムが正常に動作しています変更履歴v1
ログイン

Mercado Pago

このページで

Mercado Pagoの開始#

このページは、DEUNAとのMercado Pagoの統合に関する包括的なガイドを提供します。

仕組み

Mercado Pagoを使用すると、お客様にカードを保存するオプションを提供できます。これにより、将来の購入が容易になります。

Mercado Pagoは、APIまたはウィジェットを使用してカードをトークン化します。DEUNAは、このソリューションを使用してカードをトークン化し、Vaultに保存します。

カードが有効であることを確認してから、Mercado Pagoにカードを保存します。

以下の2つの方法で検証できます。

  • ゼロドル認証
  • 最小金額での課金

ゼロドル認証

次の ゼロドル認証 検証は、ゼロ金額での検証決済を実行することです。

この機能は、アルゼンチンおよびブラジルでのVisaおよびMastercardでのみ利用可能です。

最小金額での課金

次の 最小金額での決済 検証は、少額の検証決済を実行することであり、すぐに返金されます。

この機能は、Zero dollar authが利用できないフランチャイズおよび国でのみ利用可能です。

要件#

Mercado Pagoとの統合には、Mercado PagoまたはMercado Libreの販売者アカウントが必要です。

Mercado Pagoとの統合

技術要件が確立されたら、統合を開始できます。

1. Mercado PagoのWebhookを有効化

Mercado Pagoとのトークン化を有効にするには、まずMercado PagoのWebhook検証を有効化する必要があります。

Webhookとは

Webhookは、特定のイベントが発生するたびにリアルタイムの通知を受け取るためのツールです。

Mercado Pago がこれらの通知の発信元であることを証明するために、 requests が当方の Webhook に到達することを確認する検証が実装されています。

2. Webhook の検証

Mercado Pago は、 requests に送信する際に、常に秘密鍵を送信します。これにより、その起源を検証できます。

3. Webhook の URL の取得

Póngase en contacto con el equipo de DEUNA para solicitar la URL del webhook de Mercado Pago.

4. Webhook の設定:

Mercado Pago の 開発者パネルから Webhook を設定します。以下の手順を実行する必要があります。

  1. 開発者パネルにアクセスし、統合を選択します。


  2. 左側のメニューから Webhooks.


  3. をクリック 通知設定を選択.

  4. 「 本番環境、弊社から提供したURLを入力してください。

  5. イベントを選択 Payments および Fraud alerts

  6. をクリック 設定を保存.

5. シークレットキーを取得

ウェブフックのセクションでは、操作に必要なシークレットキーを取得する必要があります。

  1. 取得するには、 秘密鍵 パスワードボタンをクリックすることで。

  2. 取得した秘密鍵をDEUNAチームに送信してください。

  3. 必要な設定はDEUNAチームが対応します。

6. PSPにおけるトークン化の有効化

DEUNAチームがすべての必要な設定が正常に完了したことを確認した後、PSPでのトークン化を有効にする必要があります。

  1. 入力してください ADMIN
  2. 「接続」に移動し、Mercado Pagoの設定を探してください。
  3. 有効化する カードをPSPに保存する チェックボックス
  4. をクリック 編集.

7. 検証の確認

Mercado Pagoを使用したトークン化が正しく行われた場合：

  1. 応答は カードを作成する endpoint.
  2. 次の vault.provider 属性の値は Mercadopago.
JSON
"vault": {
	"provider": "Mercadopago",
	"id": "id of the vault provider"
}
  1. 次の verified_by 属性には、可能な検証方法が含まれる。
JSON
"data": {
  "verified_by": "mercadopago_minimum_amount" or "mercadopago_zero_dollar_auth"
}

観察:#

  • 次の external_reference このフィールドには、以下の要件を満たす必要があります。
    • 最大文字数：64文字
    • 許可される文字: 英数字 (文字と数字)、ハイフン (-)、アンダースコア (_)
    • 制限: ハッシュ記号 (#)、括弧、角括弧、その他の記号などの特殊文字は許可されません。