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

AMEX

このページで

American Express (AMEX) は、高額カード保有者と高度なセキュリティプロトコルで知られる、主要なグローバル決済ネットワークです。DEUNAとの直接連携により、以下の操作を実行できます。 ISO 8583Deunaの商人は、サードパーティのゲートウェイを介する必要をなくし、レイテンシの削減、処理コストの最小化、およびトランザクションデータの詳細な制御を実現します。

サポートされている操作

DEUNAとのAMEX連携により、以下の操作を実行できます。

操作AMEX名MTIリクエスト/レスポンス
認証認証1100/ 1110
購入（Deunaでの自動キャプチャ）認証1100 / 1110
完全払い戻し（翌日）/ 部分払い戻し払い戻しオフラインリクエスト
完全/部分キャプチャCaptureオフラインリクエスト
完全払い戻し（当日）承認の取り消し1420 / 1430
キャンセル承認の取り消し1420 / 1430

サポートされている機能

  • 3DS（Deunaまたは外部MPI）
  • 分割払い
  • MOTO
  • 航空会社情報

サポートされている支払い方法

  • デビットカードおよびクレジットカードVisa、Mastercard、AMEX

決済プロセス

AMEX連携には、より信頼性と効率的な照合プロセスを提供するための2段階のプロセスが必要です。リアルタイムで個々の取引をすべて処理するのではなく、承認されたすべての取引をまとめて、1日の終わりに1つのバッチファイルで送信します。これにより、日次会計、監査、およびエラーチェックが大幅に簡素化されます。カットオフ時間はCDMX時間午前11:00です。

このプロセスは、以下の表で説明されているように、Deunaの支払いステータスに反映されます。

操作AMEX名MTIリクエスト/レスポンスDeunaでの決済前ステータスDeunaでの決済後ステータス
認証認証1100/ 1110承認承認（変更なし）
購入（自動キャプチャ）認証1100 / 1110処理中処理完了
完全払い戻し（翌日）/ 部分払い戻し払い戻しオフラインリクエスト払い戻し / 一部払い戻し払い戻し / 一部払い戻し完了
完全/部分キャプチャCaptureオフラインリクエスト決済 / 一部決済決済 / 一部決済完了
完全払い戻し（当日）承認の取り消し1420 / 1430返金払い戻し（変更なし、オンラインキャンセル）
キャンセル承認の取り消し1420 / 1430キャンセルキャンセル（変更なし、オンラインでのキャンセル）

AMEXとの連携#

決済および不正行為管理プラットフォームとして、当社のプラットフォームは、AMEX merchant アカウントを簡単に決済フローに接続できるようにします。これにより、AMEX の処理能力を、高度なルールベースの決済戦略の一部として活用し、承認率を最適化し、コストを削減できます。

このガイドでは、AMEXとの接続に必要な認証情報を説明します。

要件

AMEXを当社の管理画面で設定する前に、AMEXとの有効な商社アカウントが必要です。AMEXとのオンボーディング時に、直接ISOとの統合に必要な独自の認証情報が提供されます。

以下の必要なフィールドを、AMEXの担当者またはウェルカムドキュメントから取得してください。

  • アフィリエイトID（商社ID、SE番号）： 商社アカウントの10桁の固有識別子。
  • Terminal ID: 特定の店舗のターミナルを識別する固有のコード。

設定手順

AMEXとの接続は、当社の管理ポータルでの簡単な、一度の設定です。

  1. 管理ポータルにログインしてください。

  2. 以下のパスに移動する 接続 under Payments section**,** find AMEX を選択して、 Connect.

    インタラクティブな例サンプルデータを使用し、APIリクエストは行いません。
    本番環境
    決済

    接続

    決済、ウォレット、および不正検知の統合を発見および管理します。

    Acme LATAM · 本番環境
    5 サンプル接続直前に更新
    接続種類ステータスアクション
    Adyen決済ゲートウェイ接続済み
    Worldpay決済ゲートウェイ接続済み
    PayPal決済方法接続済み
    Mercado Pago決済方法接続されていない
    Riskified不正検知エンジン接続されていない

  3. フォームが表示されます。AMEXおよびDeunaの担当者から収集した認証情報と、以下の情報を慎重に入力してください。

    名前

    詳細

    通貨

    支払いプロセッサの通貨を選択してください

    Affiliation ID

    AMEXから取得した、10桁の固有の識別子（加盟店アカウント用）

    送信者ID（Deunaから提供）

    Deunaアドバイザーから提供された送信者ID

    Acquirer Afiliation ID

    以下のコードを使用してください（お取引先の地域に応じて）：

    • アメリカ: 10000000002
    • カナダ：10000000006
    • メキシコ: 10000000005
    • アルゼンチン: 10000000085
    • EMEA（ヨーロッパ、中東、アフリカ）：10000000232
    • 日本: 10000000319

    端末ID（推奨: "00000001"）

    "00000001"を使用し、AMEXまたはDeunaから別の値が指示された場合は、それを使用してください。

    POSデータコード (デフォルト: "1000S0100010")

    "1000S0100010"を使用し、AMEXまたはDeunaから別の値が指示された場合は、それを使用してください。

    商社カテゴリコード (4桁)

    4桁のカテゴリコード（デフォルト: "4511"）

    承認コードの長さ（デフォルト: "6"）

    「6」を使用。ただし、AMEXまたはDeunaからの指示がある場合のみ。

    加盟店名

    商社名

    商社の住所（通り名、番地、部屋番号）

    商社の住所（通り名、番地、部屋番号）

    商社名

    商社が登録されている都市

    商社の郵便番号（例：「11510」）

    サービスが提供される場所または商社が登録されている郵便番号

    商社の州コード（3桁）

    サービスが提供される場所または商社が登録されている3桁の州コード。2桁のコードで構成される州の場合は、スペースを追加してください。例：フロリダ -> "FL "

    商人の国コード（3桁の数値）

    サービスが提供される場所または商社が登録されている国、3桁の数値形式で。

    販売者ID（アグリゲーターモードのみ。デフォルト「0000000000」）

    「0000000000」を使用し、AMEXまたはDEUNAからの指示がない限り。

    販売者のメールアドレス（アグリゲーターモードのみ。デフォルト「」）merchant@merchant.com")

    「」を使用merchant@merchant.comただし、AMEXまたはDeunaからの指示がある場合

    販売者の電話番号 (アグリゲーターモードでのみ使用。デフォルト: "55555555555")

    "55555555555" を使用します。ただし、AMEX または DEUNA から異なる値が指示された場合は、それを使用してください。

    メッセージ理由コード (デフォルト: "1900")

    "1900" を使用します。ただし、AMEX または DEUNA から異なる値が指示された場合は、それを使用してください。

    認証処理コード ("004000" または "004800" を使用して AAV を有効にする)

    AMEX のアドレス検証サービス (AVV) を使用する場合は、"004800" を使用します。それ以外の場合は、"004000" を使用します。

    自動アドレス検証 (AAV) の種類 ("AD" または "AE"。推奨: "AD")

    AMEX の AAV を使用する場合は:

    「AD」（推奨）または「AE」を使用してください：

    • 認証、標準（AD）：カード会員および配送に関するさまざまなレベルのデータ検証に使用されます。

    • 認証、拡張（AE）：AD形式のすべての機能をサポートし、カード会員の請求電話番号および顧客のメールアドレスに対する追加の検証オプションを提供します。

      AMEXのAAVを使用しない場合は、このフィールドに「AD」を使用してください。

  4. 「Sale (Purchase)」または「Pre Authorization (Authorization)」モードでこの接続を使用するかどうかを選択します。

  5. 必要に応じて、互換性のあるAMEX接続に対して、DEUNAが管理する3DS機能を有効にすることができます。その手順は以下のとおりです。 3DS 設定ガイド.

  6. クリック 「保存」.

  7. 当システムは認証情報を検証し、AMEXが[ブランド名]として表示されます。 「有効」 接続済みのプロセッサの一覧で


テストカード#

AMEXは、特定のPAN（ペイメントカード番号）と金額に基づいて、サンドボックス環境でのトランザクションを承認します。異なるPANと金額の組み合わせは、一般的なエラーコードでトランザクションが拒否される結果となります。 pick up card:

PAN注文合計金額（セント単位）有効期限CVV (CID)
37395319235100452500将来のいずれかいずれか
37395319235100453000将来のいずれかいずれか
37395319235100456500将来のいずれかいずれか
37395319235100457500将来のいずれかいずれか
37395319235100458500将来のいずれかいずれか
37395319235100459500将来のいずれかいずれか
37395319235100461000将来のいずれかいずれか

技術詳細: ISO 8583 認証#

当社の統合では、 1100 (Authorization Request) および 1110 (承認応答) メッセージの種類。承認率を高く維持し、責任の所在を明確にするため、以下のフィールドは必須または強く推奨されます。

注: これは、電子商取引における承認で一般的に使用される主要なフィールドの代表的なリストであり、網羅的な仕様ではありません。

フィールドフィールド名説明
MTIメッセージタイプ識別子1100 は、承認要求を示す
フィールド 2主要アカウント番号 (PAN)顧客の16～19桁のカード番号。カードIDとしてマスク表示されます。
フィールド3処理コードトランザクションの種類を示します（例：200000は購入）。
フィールド4金額、取引取引通貨での合計購入金額。セント単位で表示されます。
フィールド7送信日時取引が開始された日付と時刻 (MMDDhh:mm):ss).
フィールド 11システム追跡監査番号 (STAN)一意の6桁の番号で取引を識別します。
フィールド 12トランザクションのローカル日時取引が開始された日付と時刻 (YYMMDDhh:mm):ss).
フィールド 14有効期限カードの有効期限。YYMM形式で表示されます。ハッシュ化されています。
フィールド 19国コードトランザクションの3桁の国コード。ハッシュ化されています。
フィールド 22POS Data電子商取引の場合、これはカードが直接利用されない状態を示すものです。「1000S0100010」を期待します。
フィールド 24機能コード操作コード (承認、払い戻しなど)。ハッシュ化されています。
フィールド 25メッセージ理由コードメッセージ理由コード ("1900")。ハッシュ化されています。
フィールド 26カード受入事業コード商人のMCC。
フィールド 27承認コード承認コードの長さ ("6")
フィールド 32Acquirer Institution ID受入機関所属ID。例: "100000000"
フィールド 37取得参照番号24時間以内に一意な12桁の値でトランザクションを識別します。ハッシュ化されています。
フィールド 41Card Acceptor Terminal ID8桁のターミナルID (TID)。例: "00000001"
フィールド 42カード受入識別コード (商社ID)あなたの10桁の商人のID（設定から取得）
フィールド 43カード受入場所商社名、商社都市名 (認証情報に定義)
フィールド 47追加データ (国)請求、配送、航空券の詳細
フィールド 48追加のプライベートデータアメリカン・エキスプレスの拡張決済インディケーター。これには、プランタイプと分割回数が含まれます。プランタイプは03 (分割払い) および 05 (分割期間) です。例: "0306"。ハッシュ化することも可能です。
フィールド 49通貨コード、トランザクション3桁の数値形式のISO通貨コード（例：840はUSD）。ハッシュ化して表示
フィールド61国別利用データ3-D Secure 2.xおよび商社情報を含む
フィールド63プライベートデータAAV データが含まれます

フィールド47 追加情報（国別）（請求、配送、航空会社の詳細）

フィールド 47フィールド名説明
サブフィールド0ブランドとトランザクションタイプConcat of two digit card brand code, **in case is not airlines or IAC if is airline order. “**AXITD”
サブフィールド1(Not sent in Airline orders) CUSTOMER EMAIL ID (CE ID)顧客のメールIDは、常に「CE」という文字列です。
サブフィールド2（航空会社注文では送信されない）顧客のメールアドレス例： CFFROST@EMAILADDRESS.COM
サブフィールド3(Not sent in Airline orders) CUSTOMER HOSTNAME ID (CHID)顧客ホスト名 ID は定数文字列「CH」です。
サブフィールド 4（航空券注文には送信されません）顧客のホスト名。顧客のメールドメイン。例：「GMAIL.COM」
サブフィールド 5(Not sent in Airline orders) HTTP BROWSER TYPE ID (HBT ID)HTTP ブラウザ タイプ ID は定数文字 "HBT" です
サブフィールド 6（航空券注文には送信されません）HTTP ブラウザタイプリクエストからのユーザーエージェント：例：「MOZILLA/4.0 ～ (COMPATIBLE; MSIE WINDOWS)」MSIE5.0;WINDOWS95)
サブフィールド 7(Not sent in Airline orders) SHIP TO COUNTRY ID (STC ID)配送先国 ID は定数文字列「STC」です。
サブフィールド 8（航空券注文には送信されません）配送先国Three-digit numeric Country Code. Example 840
Subfield 9(Not sent in Airline orders) SHIPPING METHOD ID (SM ID)配送方法IDは定型文字列「SM」です。
Subfield 10(Nicht für Flugbuchungen) VersandmethodeWert für Pickup-Bestellungen ist "06", andernfalls "03" (shipping_options.type)
Subfield 11(Not sent in Airline orders) MERCHANT PRODUCT SKU ID (MPS ID)Händlerprodukt SKU ist eine konstante Zeichenkette "MPS"
Subfield 12(Nicht für Flugbuchungen) Händlerprodukt SKUSKU des teuersten Artikels, der in der Bestellung enthalten ist. Wenn kein SKU gesendet wird, ist der Wert "ND"
サブフィールド13(Nicht für Flugbuchungen) Kunden-IP-AdresseKunden-Internet-IP-Adresse
Subfield 14(Nicht für Flugbuchungen) Kunden-ANITelefonnummer ohne "+" oder Leerzeichen
Subfield 16(航空券注文のみ) 出発日Abfahrtsdatum (Format CCYYMMDD) als "20030101"
Subfield 17(Only for Airline orders) AIRLINE PASSENGER NAME ID (APN ID)Fluggesellschaft-Passagiername ID ist eine konstante Zeichenkette "APN"
Subfield 18(Nur für Flugbuchungen) PassagiernamePassagiername im Format: "FROST JANE M MRS"
Subfield 19(Nur für Flugbuchungen) Ursprung (Abflughafen)Abflughafen für den ersten Abschnitt der Reise: IATA-Code des Abflughafens als "SEA"
Subfield 20(Nur für Flugbuchungen) ZielZiel-Flughafen für den ersten Abschnitt der Reise: IATA-Code des Ziel-Flughafens JFK
Subfield 21(Only for Airline orders) ROUTING ID (RTG ID)ルーティングIDは定数文字列「RTG」です
Subfield 22（航空券注文のみ）都市数Gesamtzahl der Städte, die von beiden Ab- und Zielflughäfen besucht werden.
Subfield 23(Nur für Flugbuchungen) Routen-StädteFlughafen- oder Städekenntlichkeitscodes für jeden Abschnitt des Tickets (einschließlich Ursprung und Ziel): STL / JFK / MIA
Subfield 24(Only for Airline orders) AIRLINE CARRIERS ID (ALC ID)Airline Carrier ID ist eine konstante Zeichenkette "ALC"
Subfield 25(Nur für Flugbuchungen) Anzahl der FluggesellschaftenAnzahl der Fluggesellschaften auf der Reise
Subfield 26(Nur für Flugbuchungen) FluggesellschaftenFluggesellschaft-Code für jeden Abschnitt des Tickets (einschließlich Ursprung und Ziel). Beispiel AB / DC / EF
Subfield 27(Nur für Flugbuchungen) Fahrpreisbasis"Business"
Подполе 28(Nur für Flugbuchungen) Anzahl der PassagiereAnzahl der Passagiere im Format: 001
Subfield 29（航空券注文のみ）顧客のIPアドレスKunden-Internet-IP-Adresse. Beispiel 127.142.151.223
Subfield 30(Only for Airline orders) USTOMER EMAIL ID (CE ID)顧客のメールIDは、常に「CE」という文字列です。
Subfield 31(Only for Airline orders) USTOMER EMAIL IDKunden-E-Mail-Adresse. Beispiel:CFFROST@EMAILADDRESS.COM

Feld 61 Schlüssel-Subfelder (3DS-Details)

フィールド61フィールド名説明
サブフィールド0Primary and Secondary IDKonstante "AXASK"
サブフィールド1電子機器用部品インディケーター(ECI)Mögliche Werte: 05 = Authentifiziert mit AEVV, 06 = Versuch mit AEVV, 07 = Nicht authentifiziert
サブフィールド2AMERICAN EXPRESS VERIFICATION VALUE (AEVV) IDKonstante "AEVV"
サブフィールド3AMERICAN EXPRESS VERIFICATION VALUE(AEVV) Issuerによって生成される暗号化された値で、American ExpressSafeKeyの支払い認証の結果が使用されます。これは28文字のbase64で、デコードすると、実行された分析に関する情報が表示されます。例：「AAkBAmRGkyNEM1J5EkaTAAAAAAA="
サブフィールド 4AMERICAN EXPRESS SAFEKEY TRANSACTION ID (XID)Konstante "XID"
サブフィールド 5AMERICAN EXPRESS SAFEKEY TRANSACTION ID VALUEAmerican Express SafeKey Transaktions-ID wird während der American Express SafeKey-Zahlung authentifiziert. Base64-Wert. Beispiel: "AgIAADm0+B7htUfXuLAUcDlOUtM=”

Feld 63 Subfelder (AAV-Daten)

フィールド63フィールド名説明
サブフィールド1DIENST-IDENTIFIZIERER (AX)Konstante "AX"
サブフィールド2REQUEST TYPE IDENTIFIERAAV-Typ, der in der Konfiguration ausgewählt wurde, entweder "AD" oder "AE"
サブフィールド3CARDMEMBER BILLING POSTAL CODEBeispiel: "98107"
サブフィールド 4CARDMEMBER BILLING ADDRESSBeispiel: "6201 14TH AVE NW"
サブフィールド 5CARDMEMBER FIRST NAMEBeispiel: "LEAO"
サブフィールド 6CARDMEMBER LAST NAMEBeispiel: "BUTRON"
サブフィールド 7CARDMEMBER BILLING PHONE NUMBERZahlungs-Telefonnummer. Beispiel: "4155688537"
サブフィールド 8SHIP-TO POSTAL CODEBeispiel: "98107"
Subfield 9SHIP-TO ADDRESSBeispiel: "6201 14TH AVE NW"
Subfield 10SHIP-TO FIRST NAME例：「LOURDES」
Subfield 11SHIP-TO LAST NAMEBeispiel: "MONTENEGRO"
Subfield 12SHIP-TO PHONE NUMBER例：「4155797662」
サブフィールド13SHIP-TO COUNTRY CODELandcode in 3-stelliger Zahl, z. B. "840"

リクエストとレスポンスは、ほとんどの場合、同じフィールド名と情報を共有しており、主な違いはフィールド38と39であり、これらは認証結果に関連しています。

  • Feld 38: Autorisierungscode für Autorisierung oder Rücknull (Void) Anfrage.
  • Feld 39: Genehmigte Autorisierungsanfragen haben den Wert "000" und Genehmigte Rücknull-Anfragen haben den Wert "400" im Fall von Rücknullen (Void). Jeder andere Wert ist mit einem Fehlercode verbunden, der im Admin angezeigt wird, zusammen mit seiner Beschreibung.
  • Feld 44: AVS-Ergebniscode, ausgedrückt in einem Buchstaben. Mögliche Werte werden im nächsten Abschnitt erläutert.

AVS-Ergebnisse

Wenn AMEX AVS (AAV) in der Konfiguration mit dem Wert "004800" aktiviert ist, gibt Feld 44 das AVS-Ergebnis in einem Buchstaben zurück, das einer Deuna AVS-Fehlercode entspricht:

Amex AAV-CodeDefinitionDeuna AVS-Code
ZNur ZIP-Code ist korrektA01
A住所のみが正しいA02
KNur Kartennummer ist korrektA03
OKartennummer und Adresse sind korrektA04
LKartennummer und ZIP-Code sind korrektA05
YAdresse und ZIP-Code sind 正しいA06
NAdresse und ZIP-Code sind falschA07
MKartennummer, Adresse und ZIP sind korrektA08
EKartennummer falsch, Adresse korrekt, ZIP-Code korrektA12
F名前の入力が誤り、住所は正しい、郵便番号が誤りA13
D名前の入力が誤り、住所が誤り、郵便番号は正しいA14
W名前、住所、郵便番号がすべて誤りA15
U住所の検証情報は利用できませんA16
S住所の検証は許可されていませんA17
R住所の検証は利用できません、再試行してください。A18

次の手順#

AMEXとの接続が完了しました！

最終段階は、これをトランザクションフローに統合することです。 決済戦略 セクションで、どのトランザクションをAMEXにルーティングするかを定義するルールを作成します（例：「EURのすべてのトランザクションをAMEXにルーティング」）。

インタラクティブな例サンプルデータを使用し、APIリクエストは行いません。
本番環境
決済

決済方法

各決済フローのデフォルト処理とルールを設定します。

Acme LATAM · 本番環境

デフォルト処理

各決済フローのデフォルト処理とルールを設定します。

ルールルーティングステータスアクション
デフォルト処理Adyen → Worldpayアクティブ

特定のルール

各決済フローのデフォルト処理とルールを設定します。

1 サンプルルール決済プロセッサ
優先度ルール条件ルーティングステータス
1高額注文100ドル以上の金額Adyen → Worldpayアクティブ