FT Technologies Developer Guide {#ft-tech-about-guide} ====================================================== This section describes how to use this guide and where to find further information. Audience and Purpose : This guide is written for merchants who want to integrate FT Technologies into their payment flow. Customer Support : For support information about any service, visit the Support Center: Recent Revisions to This Document {#ft-tech-recent-revisions} ============================================================= 26.03.01 -------- Initial Release : Introduction to FT Technologies {#ft-tech-intro} ================================================ FT Technologies is a Payment Technology Partner that enables connection to processors in the Latin America and Caribbean (LAC) region. FT Technologies builds connections with Cybersource using the Common Transaction Processing (CTP) version 4 gateway. The connection supports Visa, Mastercard, American Express, Diners Club, China Union Pay, and other local card brands. Supported Networks {#ft-tech-supported-networks} ================================================ FT Technologies supports these card brands in the LAC region. | Card Brand | Numeric Code | Alpha Code | |------------------|--------------|------------| | Visa | 001 | VI | | Mastercard | 002 | MC | | American Express | 003 | AX | | Discover | 004 | DI | | Diners Club | 005 | DC | | JCB | 007 | JC | | Visa Electron | 033 | VE | | Maestro | 042 | MO | | HiperCard | 050 | HC | | Aura | 051 | AR | | Elo | 054 | EL | | Carnet | 058 | CN | | China UnionPay | 062 | CP | [Supported Traditional Card Brands] | Card Brand | Numeric Value | Alphabetic Code | Processors | |-------------|---------------|-----------------|-----------------| | Codensa | 071 | CD | FT Technologies | | Olimpica | 072 | OL | FT Technologies | | Colsubsidio | 073 | CI | FT Technologies | | Tuya | 074 | TY | FT Technologies | | Sodexo | 075 | SD | FT Technologies | | Naranja | 076 | NR | FT Technologies | | Cabal | 077 | CA | FT Technologies | | DINELCO | 078 | DE | FT Technologies | | PANAL | 079 | PN | FT Technologies | | EPM | 080 | EM | FT Technologies | [Supported Domestic Card Brands] Processing a Payment {#ft-tech-intro-txn-flow} ============================================== This workflow illustrates a successful authorization and capture. #### Figure: {#ft-tech-intro-txn-flow_fig_i1v_tzx_q3c} FT Technologies Payment Workflow ![](/content/dam/documentation/cybs/en-us/topics/payments-processing/card-processing/ft-tech/images/fttech-payment-flow-700x250.svg/jcr:content/renditions/original) 1. The cardholder initiates a purchase by entering card details online or by tapping, inserting, or swiping the card at a PoS or transit terminal. 2. The merchant sends the transaction request to Cybersource. 3. Cybersource processes the payment request and sends the request to the FT Technologies gateway. 4. FT Technologies processes the transaction and sends to domestic card schemes. 5. The domestic card scheme processes the transaction and sends it to the issuer. 6. The issuer sends approval to the domestic card scheme. 7. The domestic card scheme forwards the approval to FT Technologies. 8. FT Technologies sends the approval to Cybersource. 9. Cybersource sends the approval to the merchant. 10. FT Technologies generates and sends the clearing file to the acquirer. 11. The acquirer settles the transaction with the issuer through the appropriate domestic card scheme. Card-Not-Present Transaction Processing {#ft-tech-cnp-process-trxn-intro} ========================================================================= This section describes how to process card-not-present transactions using the `REST API`. Authorize a Payment {#ft-tech-auth-intro} ========================================= This section provides the information about how to process a payment authorization. Endpoint {#ft-tech-auth-intro_d7e260} ------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments`{#ft-tech-auth-intro_d7e268} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments`{#ft-tech-auth-intro_d7e278} Required Fields for Authorizing a Payment {#ft-tech-auth-req-fields} ==================================================================== clientReferenceInformation.code : orderInformation.amountDetails.currency : orderInformation.amountDetails.totalAmount : orderInformation.billTo.address1 : orderInformation.billTo.email : orderInformation.billTo.firstName : orderInformation.billTo.lastName : paymentInformation.card.expirationMonth : paymentInformation.card.expirationYear : paymentInformation.card.number : paymentInformation.card.type : processingInformation.commerceIndicator : Optional Fields for Authorizing a Payment {#ft-tech-auth-opt-fields} ==================================================================== orderInformation.billTo.address2 : orderInformation.billTo.administrativeArea : orderInformation.billTo.buildingNumber : orderInformation.billTo.country : orderInformation.billTo.district : orderInformation.billTo.locality : orderInformation.billTo.phoneNumber : orderInformation.billTo.postalCode : Example: Authorizing a Payment {#ft-tech-auth-ex-rest} ====================================================== Request ``` { "clientReferenceInformation": { "code": "TC-Auth-1" }, "processingInformation": { "commerceIndicator": "internet" }, "paymentInformation": { "card": { "type": "001", "number": "4111111111111111", "expirationMonth": "12", "expirationYear": "2031" } }, "orderInformation": { "amountDetails": { "totalAmount": "100.00", "currency": "BRL" }, "billTo": { "firstName": "John", "lastName": "Smith", "address1": "901 Córdoba Center Blvd", "address2": "Desk M3-5573", "locality": "Córdoba", "administrativeArea": "SP", "postalCode": "X4404-2322", "country": "BR", "email": "test@cybs.com", "phoneNumber": "4158880000", "district": "Bela Vista Æ", "buildingNumber": "1024 Metrño4" } } } ``` Response to a Successful Request ``` { "_links" : { "authReversal" : { "method" : "POST", "href" : "/pts/v2/payments/7627756274016220603092/reversals" }, "self" : { "method" : "GET", "href" : "/pts/v2/payments/7627756274016220603092" }, "capture" : { "method" : "POST", "href" : "/pts/v2/payments/7627756274016220603092/captures" } }, "clientReferenceInformation" : { "code" : "TC-Auth-1" }, "id" : "7627756274016220603092", "orderInformation" : { "amountDetails" : { "authorizedAmount" : "100.00", "currency" : "BRL" } }, "paymentAccountInformation" : { "card" : { "type" : "001" } }, "paymentInformation" : { "tokenizedCard" : { "type" : "001" }, "card" : { "type" : "001" } }, "processorInformation" : { "approvalCode" : "010012", "networkTransactionId" : "999010012", "transactionId" : "72b2900a9f316142b627a21031b48b0c259f08ffba0004172a04450c5d212345", "responseCode" : "00003", "avs" : { "code" : "2" } }, "reconciliationId" : "7627756274016220603092", "status" : "AUTHORIZED", "submitTimeUtc" : "2025-11-10T11:53:47Z" } ``` Authorization Reversal {#ft-tech-reversal-intro} ================================================ This section provides the information about how to process an authorization reversal. Reversing an authorization releases the hold on the customer's payment card funds that the issuing bank placed when processing the authorization. For a debit card or prepaid card in which only a partial amount was approved, the amount of the reversal must be the amount that was authorized, not the amount that was requested. Endpoint {#ft-tech-reversal-intro_d7e260} ----------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments`{#ft-tech-reversal-intro_d7e268} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments`{#ft-tech-reversal-intro_d7e278} Required Fields for Processing an Authorization Reversal {#ft-tech-reversal-req-fields} ======================================================================================= clientReferenceInformation.code : paymentInformation.card.expirationYear : reversalInformation.amountDetails.totalAmount : Example: Processing an Authorization Reversal {#ft-tech-reversal-ex-rest} ========================================================================= Request ``` { "clientReferenceInformation": { "code": "TC-AuthReversal-1" }, "reversalInformation": { "amountDetails": { "totalAmount": "100.00" }, "paymentInformation": { "card": { "expirationYear": "2031" } } } ``` Response to a Successful Request ``` { "_links" : { "self" : { "method" : "GET", "href" : "/pts/v2/reversals/7627759111026221603092" } }, "clientReferenceInformation" : { "code" : "RTS-Auth-Reversal" }, "id" : "7627759111026221603092", "orderInformation" : { "amountDetails" : { "currency" : "BRL" } }, "processorInformation" : { "responseCode" : "200" }, "reconciliationId" : "7627759111026221603092", "reversalAmountDetails" : { "reversedAmount" : "100.00", "currency" : "BRL" }, "status" : "REVERSED", "submitTimeUtc" : "2025-11-10T11:58:31Z" } ``` Captures {#ft-tech-capture-intro} ================================= This section provides the information you need in order to capture an authorized transaction. Endpoint {#ft-tech-capture-intro_d7e260} ---------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments`{#ft-tech-capture-intro_d7e268} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments`{#ft-tech-capture-intro_d7e278} Required Fields for Processing a Capture {#ft-tech-capture-req-fields} ====================================================================== clientReferenceInformation.code : orderInformation.amountDetails.currency : orderInformation.amountDetails.totalAmount : paymentInformation.card.expirationYear : Example: Processing a Capture {#ft-tech-capture-ex-rest} ======================================================== Request ``` { "clientReferenceInformation": { "code": "TC-Capture-1" }, "orderInformation": { "amountDetails": { "totalAmount": "100.00", "currency": "BRL" }, "paymentInformation": { "card": { "expirationYear": "2031" } } } ``` Response to a Successful Request ``` { "_links" : { "void" : { "method" : "POST", "href" : "/pts/v2/captures/7627757439636220903092/voids" }, "self" : { "method" : "GET", "href" : "/pts/v2/captures/7627757439636220903092" } }, "clientReferenceInformation" : { "code" : "RTS-Bill" }, "id" : "7627757439636220903092", "orderInformation" : { "amountDetails" : { "totalAmount" : "100.00", "currency" : "BRL" } }, "reconciliationId" : "7627756274016220603092", "status" : "PENDING", "submitTimeUtc" : "2025-11-10T11:55:44Z" } ``` Refunds {#ft-tech-refund-intro} =============================== This section provides the information you need in order to refund a transaction. Endpoint {#ft-tech-refund-intro_d7e260} --------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments`{#ft-tech-refund-intro_d7e268} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments`{#ft-tech-refund-intro_d7e278} Required Fields for Processing a Refund {#ft-tech-refund-req-fields} ==================================================================== clientReferenceInformation.code : orderInformation.amountDetails.currency : orderInformation.amountDetails.totalAmount : paymentInformation.card.expirationYear : Example: Processing a Refund {#ft-tech-refund-ex-rest} ====================================================== Request ``` { "clientReferenceInformation": { "code": "TC-Refund-1" }, "orderInformation": { "amountDetails": { "totalAmount": "100", "currency": "brl" }, "paymentInformation": { "card": { "expirationYear": "2031" } } } ``` Response to a Successful Request ``` { "_links" : { "void" : { "method" : "POST", "href" : "/pts/v2/refunds/7627898220306278903092/voids" }, "self" : { "method" : "GET", "href" : "/pts/v2/refunds/7627898220306278903092" } }, "clientReferenceInformation" : { "code" : "RTS FO Credit" }, "id" : "7627898220306278903092", "orderInformation" : { "amountDetails" : { "currency" : "brl" } }, "reconciliationId" : "7627898220306278903092", "refundAmountDetails" : { "currency" : "brl", "refundAmount" : "100.00" }, "status" : "PENDING", "submitTimeUtc" : "2025-11-10T15:50:22Z" } ``` Sales {#ft-tech-sale-intro} =========================== This section provides the information you need in order to process a sale. Endpoint {#ft-tech-sale-intro_d7e260} ------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments`{#ft-tech-sale-intro_d7e268} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments`{#ft-tech-sale-intro_d7e278} Required Fields for Processing a Sale {#ft-tech-sale-req-fields} ================================================================ clientReferenceInformation.code : orderInformation.amountDetails.currency : orderInformation.amountDetails.totalAmount : paymentInformation.card.expirationMonth : paymentInformation.card.expirationYear : paymentInformation.card.number : paymentInformation.card.type : processingInformation.capture : processingInformation.commerceIndicator : Optional Fields for Processing a Sale {#ft-tech-sale-opt-fields} ================================================================ orderInformation.billTo.address1 : {#ft-tech-sale-opt-fields_dl_rht_xwk_vhc} orderInformation.billTo.address2 : {#ft-tech-sale-opt-fields_dl_sht_xwk_vhc} orderInformation.billTo.administrativeArea : {#ft-tech-sale-opt-fields_dl_tht_xwk_vhc} orderInformation.billTo.buildingNumber : {#ft-tech-sale-opt-fields_dl_uht_xwk_vhc} orderInformation.billTo.country : {#ft-tech-sale-opt-fields_dl_vht_xwk_vhc} orderInformation.billTo.district : {#ft-tech-sale-opt-fields_dl_wht_xwk_vhc} orderInformation.billTo.email : {#ft-tech-sale-opt-fields_dl_xht_xwk_vhc} orderInformation.billTo.firstName : {#ft-tech-sale-opt-fields_dl_yht_xwk_vhc} orderInformation.billTo.lastName : {#ft-tech-sale-opt-fields_dl_zht_xwk_vhc} orderInformation.billTo.locality : {#ft-tech-sale-opt-fields_dl_a3t_xwk_vhc} orderInformation.billTo.phoneNumber : {#ft-tech-sale-opt-fields_dl_b3t_xwk_vhc} orderInformation.billTo.postalCode : {#ft-tech-sale-opt-fields_dl_c3t_xwk_vhc} Example: Processing a Sale {#ft-tech-sale-ex-rest} ================================================== Request ``` { "clientReferenceInformation": { "code": "TC-Sale-1" }, "processingInformation": { "commerceIndicator": "internet", "capture": true }, "paymentInformation": { "card": { "type": "001", "number": "4111111111111111", "expirationMonth": "12", "expirationYear": "2031" } }, "orderInformation": { "amountDetails": { "totalAmount": "100.00", "currency": "BRL" }, "billTo": { "firstName": "John", "lastName": "Smith", "address1": "901 Córdoba Center Blvd", "address2": "Desk M3-5573", "locality": "Córdoba", "administrativeArea": "SP", "postalCode": "X4404-2322", "country": "BR", "email": "test@cybs.com", "phoneNumber": "4158880000", "district": "Bela Vista Æ", "buildingNumber": "1024 Metrño4" } } } ``` Response to a Successful Request ``` { "_links" : { "void" : { "method" : "POST", "href" : "/pts/v2/payments/7627760386586222103092/voids" }, "self" : { "method" : "GET", "href" : "/pts/v2/payments/7627760386586222103092" } }, "clientReferenceInformation" : { "code" : "TC-Sale-1" }, "id" : "7627760386586222103092", "orderInformation" : { "amountDetails" : { "totalAmount" : "100.00", "authorizedAmount" : "100.00", "currency" : "BRL" } }, "paymentAccountInformation" : { "card" : { "type" : "001" } }, "paymentInformation" : { "tokenizedCard" : { "type" : "001" }, "card" : { "type" : "001" } }, "processorInformation" : { "approvalCode" : "010012", "networkTransactionId" : "999010012", "transactionId" : "72b2900a9f316142b627a21031b48b0c259f08ffba0004172a04450c5d212345", "responseCode" : "00003", "avs" : { "code" : "2" } }, "reconciliationId" : "7627760386586222103092", "status" : "AUTHORIZED", "submitTimeUtc" : "2025-11-10T12:00:38Z" } ``` Autocapture Sales {#ft-tech-sale-autocapture-intro} =================================================== This section provides the information you need in order to process a sale with the autocapture feature. Endpoint {#ft-tech-sale-autocapture-intro_d7e260} ------------------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments`{#ft-tech-sale-autocapture-intro_d7e268} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments`{#ft-tech-sale-autocapture-intro_d7e278} Required Fields for Processing an Autocapture Sale {#ft-tech-sale-autocapture-req-fields} ========================================================================================= clientReferenceInformation.code : orderInformation.amountDetails.currency : orderInformation.amountDetails.totalAmount : paymentInformation.card.expirationMonth : paymentInformation.card.expirationYear : paymentInformation.card.number : paymentInformation.card.type : paymentInformation.card.useAs : processingInformation.authorizationOptions.authType : Set to `autocapture`. processingInformation.capture : Set to `true`. processingInformation.commerceIndicator : Optional Fields for Processing an Autocapture Sale {#ft-tech-sale-autocapture-opt-fields} ========================================================================================= orderInformation.billTo.address1 : orderInformation.billTo.address2 : orderInformation.billTo.administrativeArea : orderInformation.billTo.buildingNumber : orderInformation.billTo.country : orderInformation.billTo.district : orderInformation.billTo.email : orderInformation.billTo.firstName : orderInformation.billTo.lastName : orderInformation.billTo.locality : orderInformation.billTo.phoneNumber : orderInformation.billTo.postalCode : Example: Processing an Autocapture Sale {#ft-tech-sale-autocapture-ex-rest} =========================================================================== Request ``` { "clientReferenceInformation": { "code": "TC-Sale-1" }, "processingInformation": { "commerceIndicator": "internet", "capture": true, "authorizationOptions": { "authType": "autocapture" } }, "paymentInformation": { "card": { "type": "001", "number": "4111111111111111", "expirationMonth": "12", "expirationYear": "2031", "useAs": "CR" } }, "orderInformation": { "amountDetails": { "totalAmount": "100.00", "currency": "BRL" }, "billTo": { "firstName": "John", "lastName": "Smith", "address1": "901 Córdoba Center Blvd", "address2": "Desk M3-5573", "locality": "Córdoba", "administrativeArea": "SP", "postalCode": "X4404-2322", "country": "BR", "email": "test@cybs.com", "phoneNumber": "4158880000", "district": "Bela Vista Æ", "buildingNumber": "1024 Metrño4" } } } ``` Response to a Successful Request ``` { "_links" : { "void" : { "method" : "POST", "href" : "/pts/v2/payments/7627760714776222203092/voids" }, "self" : { "method" : "GET", "href" : "/pts/v2/payments/7627760714776222203092" } }, "clientReferenceInformation" : { "code" : "TC-Sale-1" }, "id" : "7627760714776222203092", "orderInformation" : { "amountDetails" : { "totalAmount" : "100.00", "authorizedAmount" : "100.00", "currency" : "BRL" } }, "paymentAccountInformation" : { "card" : { "type" : "001" } }, "paymentInformation" : { "tokenizedCard" : { "type" : "001" }, "card" : { "type" : "001" } }, "processorInformation" : { "approvalCode" : "010012", "networkTransactionId" : "999010012", "transactionId" : "72b2900a9f316142b627a21031b48b0c259f08ffba0004172a04450c5d212345", "responseCode" : "00003", "avs" : { "code" : "2" } }, "reconciliationId" : "7627760714776222203092", "status" : "AUTHORIZED", "submitTimeUtc" : "2025-11-10T12:01:11Z" } ``` Voids {#ft-tech-void-intro} =========================== This section provides the information you need in order to void a transaction. Endpoint {#ft-tech-void-intro_d7e260} ------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments`{#ft-tech-void-intro_d7e268} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments`{#ft-tech-void-intro_d7e278} Required Fields for Processing a Void {#ft-tech-void-req-fields} ================================================================ clientReferenceInformation.code : paymentInformation.card.expirationYear : Example: Processing a Void {#ft-tech-void-ex-rest} ================================================== Request ``` { "clientReferenceInformation": { "code": "TC-Void-1" } "paymentInformation": { "card": { "expirationYear": "2031" } } } ``` Response to a Successful Request ``` { "_links" : { "self" : { "method" : "GET", "href" : "/pts/v2/reversals/7627887411406094903093" } }, "clientReferenceInformation" : { "code" : "RTS-Void" }, "id" : "7627887411406094903093", "orderInformation" : { "amountDetails" : { "currency" : "BRL" } }, "processorInformation" : { "responseCode" : "200" }, "reversalAmountDetails" : { "reversedAmount" : "100.00", "currency" : "BRL" }, "status" : "REVERSED", "submitTimeUtc" : "2025-11-10T15:32:22Z" } ``` Card-Present Transaction Processing {#ft-tech-cp-process-trxn-intro} ==================================================================== This section describes how to process card-present transactions using the `REST API`. Authorization with Contact EMV and Online PIN {#ft-tech-cp-emv-contact-onlinepin-auth-intro} ============================================================================================ This section provides the information you need in order to process an authorization with contact EMV and an online PIN. For an EMV chip contact authorization, the customer inserts the card directly into a point-of-sale (POS) terminal. For an online PIN authorization, the customer enters a PIN to verify their identity, and the issuer verifies the PIN. Online PIN transactions are supported by these card types: * Visa * Mastercard * American Express * Discover Endpoint {#ft-tech-cp-emv-contact-onlinepin-auth-intro_d7e260} -------------------------------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments`{#ft-tech-cp-emv-contact-onlinepin-auth-intro_d7e268} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments`{#ft-tech-cp-emv-contact-onlinepin-auth-intro_d7e278} Required Fields for Processing an Authorization with Contact EMV and Online PIN {#ft-tech-cp-emv-contact-onlinepin-auth-reqfields} ================================================================================================================================== clientReferenceInformation.code : merchantDefinedInformation.key : merchantDefinedInformation.value : orderInformation.amountDetails.currency : orderInformation.amountDetails.totalAmount : paymentInformation.card.expirationMonth : paymentInformation.card.expirationYear : paymentInformation.card.number : paymentInformation.card.type : pointOfSaleInformation.cardPresent : Set to `true`. pointOfSaleInformation.emv.cardSequenceNumber : pointOfSaleInformation.emv.cardholderVerificationMethodUsed : pointOfSaleInformation.emv.tags : pointOfSaleInformation.entryMode : Set to `contact`. pointOfSaleInformation.pin.blockEncodingFormat : pointOfSaleInformation.pin.encryptedPin : pointOfSaleInformation.pin.keySerialNumber : pointOfSaleInformation.pinEntryCapability : pointOfSaleInformation.terminalCapability : pointOfSaleInformation.trackData : pointOfSaleInformation.transactionDateTime : processingInformation.capture : Set to `false`. processingInformation.commerceIndicator : senderInformation.referenceNumber : Optional Fields for Processing an Authorization with Contact EMV and Online PIN {#ft-tech-cp-emv-contact-onlinepin-auth-optfields} ================================================================================================================================== orderInformation.billTo.address1 : orderInformation.billTo.administrativeArea : orderInformation.billTo.buildingNumber : orderInformation.billTo.country : orderInformation.billTo.district : orderInformation.billTo.email : orderInformation.billTo.firstName : orderInformation.billTo.lastName : orderInformation.billTo.locality : orderInformation.billTo.phoneNumber : orderInformation.billTo.postalCode : Example: Processing an Authorization with Contact EMV and Online PIN {#ft-tech-cp-emv-contact-onlinepin-auth-ex-rest} ===================================================================================================================== Request ``` { "clientReferenceInformation": { "code": "test123" }, "processingInformation": { "capture": false, "commerceIndicator": "retail" }, "paymentInformation": { "card": { "number": "4111111111111111", "expirationMonth": "12", "expirationYear": "2026", "type": "001" } }, "orderInformation": { "amountDetails": { "totalAmount": "9990.00", "currency": "BRL" }, "billTo": { "firstName": "Júlia", "lastName": "Fernández", "address1": "R. Augusta Æ", "address2": "ßloco 01", "locality": "Sáo Paulo", "administrativeArea": "SP", "postalCode": "01310-000", "country": "BR", "email": "null@cybersource.com", "phoneNumber": "999-999-9999", "buildingNumber": "1024 Metrño4", "district": "Bela Vista Æ" } }, "pointOfSaleInformation": { "terminalCapability": 4, "entryMode": "contact", "cardPresent": true, "pinEntryCapability": 6, "trackData": "%B4111111111111111^JONES/JONES^3112101976110000868000000;4111111111111111=31121019761186800000?", "emv": { "tags": "9F1E0830303131323233339F02060000000009009C01009A030608025F2A0209789F1A0204849F260856BF299472BDB0C82025C009F360245679F370412135414950540800080009F102006011A03900000112233445566778899AABBCCDD0390000011223344556677889F5301039F41030122339F03060001020304058407A00000000410109F2701809F34035E03009F090243219F3501059F3303E0B8C89110001122334455667788010203040506079F5B1000112233445566778801020304050607", "cardSequenceNumber": "01", "cardholderVerificationMethodUsed": "2" }, "pin": { "keySerialNumber": "FFFF1B1D140000200001", "blockEncodingFormat": "0", "encryptedPin": "F509429A3C3FD201" }, "transactionDateTime": "20230724085022" }, "merchantDefinedInformation": [ { "key": "merchant_transaction_identifier", "value": "uniqueValue1006" }, { "key": "third_party_certification_number", "value": "testTPCN" } ], "senderInformation": { "referenceNumber": "ms_user" } } ``` Response to a Successful Request ``` { "_links" : { "authReversal" : { "method" : "POST", "href" : "/pts/v2/payments/7627846224096435203093/reversals" }, "self" : { "method" : "GET", "href" : "/pts/v2/payments/7627846224096435203093" }, "capture" : { "method" : "POST", "href" : "/pts/v2/payments/7627846224096435203093/captures" } }, "clientReferenceInformation" : { "code" : "test123" }, "id" : "7627846224096435203093", "orderInformation" : { "amountDetails" : { "authorizedAmount" : "9990.00", "currency" : "BRL" } }, "paymentAccountInformation" : { "card" : { "type" : "001" } }, "paymentInformation" : { "tokenizedCard" : { "type" : "001" }, "card" : { "type" : "001" } }, "processorInformation" : { "approvalCode" : "010012", "networkTransactionId" : "999010012", "transactionId" : "72b2900a9f316142b627a21031b48b0c259f08ffba0004172a04450c5d212345", "responseCode" : "00003", "avs" : { "code" : "2" } }, "reconciliationId" : "7627846224096435203093", "status" : "AUTHORIZED", "submitTimeUtc" : "2025-11-10T14:23:42Z" } ``` Authorization with Contactless EMV and Online PIN {#ft-tech-cp-emv-contactless-onlinepin-auth-intro} ==================================================================================================== This section provides the information you need in order to process an authorization with contactless EMV and an online PIN. For an EMV contactless payment, the customer taps the card on the terminal. The terminal and chip use near-field communication (NFC) to communicate with each other. For an online PIN transaction, the customer uses a PIN to verify their identity and the issuer verifies the PIN. Online PIN transactions are supported by these card types: * Visa * Mastercard * American Express * Discover Endpoint {#ft-tech-cp-emv-contactless-onlinepin-auth-intro_d7e260} ------------------------------------------------------------------ **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments`{#ft-tech-cp-emv-contactless-onlinepin-auth-intro_d7e268} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments`{#ft-tech-cp-emv-contactless-onlinepin-auth-intro_d7e278} Required Fields for Processing an Authorization with Contactless EMV and Online PIN {#ft-tech-cp-emv-contactless-onlinepin-auth-reqfields} ========================================================================================================================================== clientReferenceInformation.code : merchantDefinedInformation.key : merchantDefinedInformation.value : orderInformation.amountDetails.currency : orderInformation.amountDetails.totalAmount : paymentInformation.card.expirationMonth : paymentInformation.card.expirationYear : paymentInformation.card.number : paymentInformation.card.type : pointOfSaleInformation.cardPresent : Set to `true`. pointOfSaleInformation.emv.cardSequenceNumber : pointOfSaleInformation.emv.cardholderVerificationMethodUsed : pointOfSaleInformation.emv.tags : pointOfSaleInformation.entryMode : Set to `contactless`. pointOfSaleInformation.pin.blockEncodingFormat : pointOfSaleInformation.pin.encryptedPin : pointOfSaleInformation.pin.keySerialNumber : pointOfSaleInformation.pinEntryCapability : pointOfSaleInformation.terminalCapability : pointOfSaleInformation.trackData : pointOfSaleInformation.transactionDateTime : processingInformation.authorizationOptions.partialAuthIndicator : processingInformation.capture : Set to `false`. processingInformation.commerceIndicator : senderInformation.referenceNumber : Optional Fields for Processing an Authorization with Contactless EMV and Online PIN {#ft-tech-cp-emv-contactless-onlinepin-auth-optfields} ========================================================================================================================================== orderInformation.billTo.address1 : orderInformation.billTo.administrativeArea : orderInformation.billTo.buildingNumber : orderInformation.billTo.country : orderInformation.billTo.district : orderInformation.billTo.email : orderInformation.billTo.firstName : orderInformation.billTo.lastName : orderInformation.billTo.locality : orderInformation.billTo.phoneNumber : orderInformation.billTo.postalCode : Example: Processing an Authorization with Contactless EMV and Online PIN {#ft-tech-cp-emv-contactless-onlinepin-auth-ex-rest} ============================================================================================================================= Request ``` { "clientReferenceInformation": { "code": "test123" }, "processingInformation": { "capture": false, "commerceIndicator": "retail", "authorizationOptions": { "partialAuthIndicator": true } }, "paymentInformation": { "card": { "number": "4111111111111111", "expirationMonth": "12", "expirationYear": "2026", "type": "001" } }, "orderInformation": { "amountDetails": { "totalAmount": "9900.00", "currency": "BRL" }, "billTo": { "firstName": "Júlia", "lastName": "Fernández", "address1": "R. Augusta Æ", "address2": "ßloco 01", "locality": "Sáo Paulo", "administrativeArea": "SP", "postalCode": "01310-000", "country": "BR", "email": "null@cybersource.com", "phoneNumber": "999-999-9999", "buildingNumber": "1024 Metrño4", "district": "Bela Vista Æ" } }, "pointOfSaleInformation": { "terminalId": "12345678", "terminalCapability": "5", "entryMode": "contactless", "cardPresent": true, "pinEntryCapability": "0", "trackData": "%B4111111111111111^JONES/JONES ^3112101976110000868000000?;4111111111111111=31121019761186800000?", "emv": { "tags": "9F1E0830303131323233339F02060000000009009C01009A030608025F2A0209789F1A0204849F260856BF299472BDB0C782025C009F360245679F370412135414950540800080009F102006011A03900000112233445566778899AABBCCDD03900000112 23344556677889F5301039F41030122339F03060001020304058407A00000000410109F2701809F34035E03009F090243219F3501059F3303E0B8C89110001122334455667788010203040506079F5B1000112233445566778801020304050607", "cardSequenceNumber": "01" }, "pin": { "keySerialNumber": "FFFF1B1D140000200001", "blockEncodingFormat": "0", "encryptedPin": "F509429A3C3FD201" }, "transactionDateTime": "20230724085022" }, "merchantDefinedInformation": [ { "key": "merchant_transaction_identifier", "value": "uniqueValue1010" }, { "key": "third_party_certification_number", "value": "testTPCN" } ], "senderInformation": { "referenceNumber": "ms_user" } } ``` Response to a Successful Request ``` { "_links" : { "authReversal" : { "method" : "POST", "href" : "/pts/v2/payments/7627850219976435403093/reversals" }, "self" : { "method" : "GET", "href" : "/pts/v2/payments/7627850219976435403093" }, "capture" : { "method" : "POST", "href" : "/pts/v2/payments/7627850219976435403093/captures" } }, "clientReferenceInformation" : { "code" : "test123" }, "id" : "7627850219976435403093", "orderInformation" : { "amountDetails" : { "authorizedAmount" : "9900.00", "currency" : "BRL" } }, "paymentAccountInformation" : { "card" : { "type" : "001" } }, "paymentInformation" : { "tokenizedCard" : { "type" : "001" }, "card" : { "type" : "001" } }, "processorInformation" : { "approvalCode" : "010012", "networkTransactionId" : "999010012", "transactionId" : "72b2900a9f316142b627a21031b48b0c259f08ffba0004172a04450c5d212345", "responseCode" : "00003", "avs" : { "code" : "2" }, "pointOfSaleInformation": { "emv": { "tags": "910AAB002233445577883030 } }, "reconciliationId" : "7627850219976435403093", "status" : "AUTHORIZED", "submitTimeUtc" : "2025-11-10T14:30:22Z" } ``` Authorization with Magnetic Stripe Swipe {#ft-tech-cp-services-auth-mag-intro} ============================================================================== This section provides the information you need in order to process an authorization with a magnetic stripe swipe. Although EMV chips on payment cards have become common, sometimes the EMV chip cannot be used to validate the cardholder. In these instances, you can choose to validate the cardholder by using the magnetic stripe on back of the payment card. Endpoint {#ft-tech-cp-services-auth-mag-intro_d7e260} ----------------------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments`{#ft-tech-cp-services-auth-mag-intro_d7e268} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments`{#ft-tech-cp-services-auth-mag-intro_d7e278} Required Fields for Processing an Authorization with Magnetic Stripe Swipe {#ft-tech-cp-auth-mag-reqfields} =========================================================================================================== clientReferenceInformation.code : merchantDefinedInformation.key : merchantDefinedInformation.value : orderInformation.amountDetails.currency : orderInformation.amountDetails.totalAmount : {#ft-tech-cp-auth-mag-reqfields_dl_jhb_2hl_vhc} orderInformation.billTo.firstName : {#ft-tech-cp-auth-mag-reqfields_dl_e3b_2hl_vhc} orderInformation.billTo.lastName : {#ft-tech-cp-auth-mag-reqfields_dl_f3b_2hl_vhc} paymentInformation.card.expirationMonth : paymentInformation.card.expirationYear : paymentInformation.card.number : paymentInformation.card.type : pointOfSaleInformation.cardPresent : pointOfSaleInformation.cardholderVerificationMethod : pointOfSaleInformation.entryMode : pointOfSaleInformation.terminalCapability : pointOfSaleInformation.terminalId : pointOfSaleInformation.trackData : processingInformation.capture : processingInformation.commerceIndicator : senderInformation.referenceNumber : Optional Fields for Processing an Authorization with Magnetic Stripe Swipe {#ft-tech-cp-emv-auth-mag-optfields} =============================================================================================================== orderInformation.billTo.address1 : orderInformation.billTo.administrativeArea : orderInformation.billTo.buildingNumber : orderInformation.billTo.country : orderInformation.billTo.district : orderInformation.billTo.email : orderInformation.billTo.firstName : orderInformation.billTo.lastName : orderInformation.billTo.locality : orderInformation.billTo.phoneNumber : orderInformation.billTo.postalCode : Example: Processing an Authorization with Magnetic Stripe Swipe {#ft-tech-cp-emv-auth-mag-ex-rest} ================================================================================================== Request ``` { "clientReferenceInformation": { "code": "TC-Vero-2" }, "processingInformation": { "capture": false, "commerceIndicator": "retail" }, "paymentInformation": { "card": { "number": "4111111111111111", "expirationMonth": "12", "expirationYear": "2026", "type": "001" } }, "orderInformation": { "amountDetails": { "totalAmount": "9601.00", "currency": "BRL" }, "billTo": { "firstName": "Júlia", "lastName": "Fernández", "address1": "R. Augusta Æ", "address2": "ßloco 01", "locality": "Sáo Paulo", "administrativeArea": "SP", "postalCode": "01310-000", "country": "BR", "email": "null@cybersource.com", "phoneNumber": "999-999-9999", "buildingNumber": "1024 Metrño4", "district": "Bela Vista Æ" } }, "pointOfSaleInformation": { "terminalId": "12345678", "terminalCapability": "4", "entryMode": "swiped", "cardPresent": true, "trackData": "%B4111111111111111^JONES/JONES ^3112101976110000868000000?;4111111111111111=16121019761186800000?", "cardholderVerificationMethod": "1" }, "merchantDefinedInformation": [ { "key": "third_party_certification_number", "value": "123456789012" } ], "senderInformation": { "referenceNumber": "ms_user" } } ``` Response to a Successful Request ``` { "_links" : { "authReversal" : { "method" : "POST", "href" : "/pts/v2/payments/7627852931116436203093/reversals" }, "self" : { "method" : "GET", "href" : "/pts/v2/payments/7627852931116436203093" }, "capture" : { "method" : "POST", "href" : "/pts/v2/payments/7627852931116436203093/captures" } }, "clientReferenceInformation" : { "code" : "TC-Vero-2" }, "id" : "7627852931116436203093", "orderInformation" : { "amountDetails" : { "authorizedAmount" : "9601.00", "currency" : "BRL" } }, "paymentAccountInformation" : { "card" : { "type" : "001" } }, "paymentInformation" : { "tokenizedCard" : { "type" : "001" }, "card" : { "type" : "001" } }, "processorInformation" : { "approvalCode" : "010012", "networkTransactionId" : "999010012", "transactionId" : "72b2900a9f316142b627a21031b48b0c259f08ffba0004172a04450c5d212345", "responseCode" : "00003", "avs" : { "code" : "2" } }, "reconciliationId" : "7627852931116436203093", "status" : "AUTHORIZED", "submitTimeUtc" : "2025-11-10T14:34:53Z" } ``` Sale with Magnetic Stripe Swipe {#ft-tech-cp-services-sale-mag-intro} ===================================================================== This section provides the information you need in order to process a sale with a magnetic stripe swipe. Although EMV chips on payment cards have become common, sometimes the EMV chip cannot be used to validate the cardholder. In these instances, you can choose to complete the sale by using the magnetic stripe on back of the payment card. Endpoint {#ft-tech-cp-services-sale-mag-intro_d7e260} ----------------------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments`{#ft-tech-cp-services-sale-mag-intro_d7e268} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments`{#ft-tech-cp-services-sale-mag-intro_d7e278} Required Fields for Processing a Sale with Magnetic Stripe Swipe {#ft-tech-cp-sale-mag-reqfields} ================================================================================================= clientReferenceInformation.code : merchantDefinedInformation.key : merchantDefinedInformation.value : orderInformation.amountDetails.currency : orderInformation.amountDetails.totalAmount : orderInformation.billTo.firstName : orderInformation.billTo.lastName : paymentInformation.card.expirationMonth : paymentInformation.card.expirationYear : paymentInformation.card.number : paymentInformation.card.type : pointOfSaleInformation.cardPresent : pointOfSaleInformation.cardholderVerificationMethod : pointOfSaleInformation.entryMode : pointOfSaleInformation.terminalCapability : pointOfSaleInformation.terminalId : pointOfSaleInformation.trackData : processingInformation.capture : processingInformation.commerceIndicator : senderInformation.referenceNumber : Optional Fields for Processing a Sale with Magnetic Stripe Swipe {#ft-tech-cp-emv-sale-mag-optfields} ===================================================================================================== orderInformation.billTo.address1 : orderInformation.billTo.administrativeArea : orderInformation.billTo.buildingNumber : orderInformation.billTo.country : orderInformation.billTo.district : orderInformation.billTo.email : orderInformation.billTo.firstName : orderInformation.billTo.lastName : orderInformation.billTo.locality : orderInformation.billTo.phoneNumber : orderInformation.billTo.postalCode : Example: Processing a Sale with Magnetic Stripe Swipe {#ft-tech-cp-emv-sale-mag-ex-rest} ======================================================================================== Request ``` { "clientReferenceInformation": { "code": "TC-Vero-2" }, "processingInformation": { "capture": true, "commerceIndicator": "retail" }, "paymentInformation": { "card": { "number": "4111111111111111", "expirationMonth": "12", "expirationYear": "2026", "type": "001" } }, "orderInformation": { "amountDetails": { "totalAmount": "9601.00", "currency": "BRL" }, "billTo": { "firstName": "Júlia", "lastName": "Fernández", "address1": "R. Augusta Æ", "address2": "ßloco 01", "locality": "Sáo Paulo", "administrativeArea": "SP", "postalCode": "01310-000", "country": "BR", "email": "null@cybersource.com", "phoneNumber": "999-999-9999", "buildingNumber": "1024 Metrño4", "district": "Bela Vista Æ" } }, "pointOfSaleInformation": { "terminalId": "12345678", "terminalCapability": "4", "entryMode": "swiped", "cardPresent": true, "trackData": "%B4111111111111111^JONES/JONES ^3112101976110000868000000?;4111111111111111=16121019761186800000?", "cardholderVerificationMethod": "1" }, "merchantDefinedInformation": [ { "key": "third_party_certification_number", "value": "123456789012" } ], "senderInformation": { "referenceNumber": "ms_user" } } ``` Response to a Successful Request ``` { "_links" : { "void" : { "method" : "POST", "href" : "/pts/v2/payments/7627854137016436503093/voids" }, "self" : { "method" : "GET", "href" : "/pts/v2/payments/7627854137016436503093" } }, "clientReferenceInformation" : { "code" : "TC-Vero-2" }, "id" : "7627854137016436503093", "orderInformation" : { "amountDetails" : { "totalAmount" : "9601.00", "authorizedAmount" : "9601.00", "currency" : "BRL" } }, "paymentAccountInformation" : { "card" : { "type" : "001" } }, "paymentInformation" : { "tokenizedCard" : { "type" : "001" }, "card" : { "type" : "001" } }, "processorInformation" : { "approvalCode" : "010012", "networkTransactionId" : "999010012", "transactionId" : "72b2900a9f316142b627a21031b48b0c259f08ffba0004172a04450c5d212345", "responseCode" : "00003", "avs" : { "code" : "2" } }, "reconciliationId" : "7627854137016436503093", "status" : "AUTHORIZED", "submitTimeUtc" : "2025-11-10T14:36:53Z" } ``` Authorization Reversal {#ft-tech-cp-auth-reversal-intro} ======================================================== This section provides the information about how to process an authorization reversal. Reversing an authorization releases the hold on the customer's payment card funds that the issuing bank placed when processing the authorization. For a debit card or prepaid card in which only a partial amount was approved, the amount of the reversal must be the amount that was authorized, not the amount that was requested. Endpoint {#ft-tech-cp-auth-reversal-intro_d7e260} ------------------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments`{#ft-tech-cp-auth-reversal-intro_d7e268} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments`{#ft-tech-cp-auth-reversal-intro_d7e278} Required Fields for Processing an Authorization Reversal {#ft-tech-cp-auth-reversal-reqfields} ============================================================================================== clientReferenceInformation.code : orderInformation.amountDetails.currency : reversalInformation.amountDetails.totalAmount : Example: Processing an Authorization Reversal {#ft-tech-cp-auth-reversal-ex-rest} ================================================================================= Request ``` { "clientReferenceInformation" : { "code" : "RTS-Auth-Reversal" }, "orderInformation" : { "amountDetails" : { "currency"" : "BRL" } }, "reversalInformation" : { "amountDetails" : { "totalAmount" : "9900.00" } } } ``` Response to a Successful Request ``` { "clientReferenceInformation" : { "code" : "RTS-Auth-Reversal" }, "orderInformation" : { "amountDetails" : { "currency" : "brl" } }, "reversalInformation" : { "amountDetails" : { "totalAmount" : "9900.00" } } } ``` Mass Transit Transaction Processing {#ft-tech-mtt-trxn-intro} ============================================================= This section describes how to process Mass Transit transactions using the `REST API`. Authorization with EMV Data {#ft-tech-mtt-emv-auth-intro} ========================================================= This section provides the information you need in order to process an authorization with EMV data. Endpoint {#ft-tech-mtt-emv-auth-intro_d7e260} --------------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments`{#ft-tech-mtt-emv-auth-intro_d7e268} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments`{#ft-tech-mtt-emv-auth-intro_d7e278} Required Fields for Processing an Authorization with EMV Data {#ft-tech-mtt-emv-auth-reqfields} =============================================================================================== clientReferenceInformation.code : orderInformation.amountDetails.currency : orderInformation.amountDetails.totalAmount : orderInformation.billTo.address1 : orderInformation.billTo.address2 : orderInformation.billTo.administrativeArea : orderInformation.billTo.buildingNumber : orderInformation.billTo.country : orderInformation.billTo.district : orderInformation.billTo.email : orderInformation.billTo.firstName : orderInformation.billTo.lastName : orderInformation.billTo.locality : orderInformation.billTo.phoneNumber : orderInformation.billTo.postalCode : paymentInformation.card.expirationMonth : paymentInformation.card.expirationYear : paymentInformation.card.number : paymentInformation.card.type : paymentInformation.initiationChannel : pointOfSaleInformation.cardPresent : pointOfSaleInformation.catLevel : pointOfSaleInformation.emv.cardSequenceNumber : pointOfSaleInformation.emv.tags : pointOfSaleInformation.entryMode : pointOfSaleInformation.terminalCapability : pointOfSaleInformation.terminalPinCapability : pointOfSaleInformation.trackData : processingInformation.authorizationOptions.authIndicator : processingInformation.capture : processingInformation.commerceIndicator : processingInformation.industryDataType : Example: Processing an Authorization with EMV Data {#ft-tech-mtt-emv-auth-ex-rest} ================================================================================== Request ``` { "orderInformation": { "billTo": { "address1": "R. Augusta Æ", "address2": "ßloco 01", "buildingNumber": "1024 Metrño4", "locality": "Sáo Paulo", "country": "BR", "district": "Bela Vista Æ", "administrativeArea": "SP", "postalCode": "01310-000", "email": "null@cybersource.com", "firstName": "Júlia", "lastName": "Fernández", "phoneNumber": "999-999-9999" }, "amountDetails": { "totalAmount": "100.00", "currency": "BRL" } }, "paymentInformation": { "card": { "type": "002", "expirationMonth": "12", "expirationYear": "2026", "number": "5555555555554444" }, "initiationChannel": "00" }, "pointOfSaleInformation": { "cardPresent": "Y", "entryMode": "contact", "terminalCapability": "4", "terminalPinCapability": "6", "trackData": "%B4111111111111111^JONES/JONES ^3112101976110000868000000?;4111111111111111=16121019761186800000?", "emv": { "cardSequenceNumber": "01", "tags": "5F3401019F3303E0F8C8950580800480009F370465B81A3A9F100706011203A0A0009F2608E9D097D1901E8AB99F36020002820218009C01009F1A0208409A032307259F02060000000007005F2A0208409F0306000000000000DF78083831393 931303236DF791B322D30323436362D312D31432D5246492D30333\n1332D342E332E62" }, "catLevel": "2" }, "processingInformation": { "capture": false, "commerceIndicator": "retail", "industryDataType": "transit", "authorizationOptions": { "authIndicator": "0" } }, "clientReferenceInformation": { "code": "TC-Vero-2" } } ``` Response to a Successful Request ``` { "_links": { "authReversal": { "method": "POST", "href": "/pts/v2/payments/7696018056967001927451/reversals" }, "self": { "method": "GET", "href": "/pts/v2/payments/7696018056967001927451" }, "capture": { "method": "POST", "href": "/pts/v2/payments/7696018056967001927451/captures" } }, "clientReferenceInformation": { "code": "TC-Vero-2" }, "id": "7696018056967001927451", "orderInformation": { "amountDetails": { "authorizedAmount": "100.00", "currency": "BRL" } }, "paymentAccountInformation": { "card": { "type": "002" } }, "paymentInformation": { "tokenizedCard": { "type": "002" }, "card": { "type": "002" } }, "pointOfSaleInformation": { "terminalId": "11111111", "emv": { "tags": "9F03060000000000009F0206000000960100820220009F3901078407A00000000310109F370487A1C9E29F360202299F34031F00009F3303E0B0C85F2A0201889F6E04207000009F270180950500000000009F260891BF08455A7DC8B35F3401019A032008079C01009F1B060000003000009F1A0201889F100706020A03A02800" } }, "processorInformation": { "approvalCode": "800000", "networkTransactionId": "345678901876", "transactionId": "345678901876", "responseCode": "00", "avs": { "code": "2" } }, "reconciliationId": "7696018056967001927451", "status": "AUTHORIZED", "submitTimeUtc": "2026-01-28T12:03:27Z" } ``` Aggregated Authorization with EMV Data {#ft-tech-mtt-emv-agg-auth-intro} ======================================================================== This section provides the information you need in order to process an aggregated EMV chip contact authorization. Endpoint {#ft-tech-mtt-emv-agg-auth-intro_d7e260} ------------------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments`{#ft-tech-mtt-emv-agg-auth-intro_d7e268} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments`{#ft-tech-mtt-emv-agg-auth-intro_d7e278} Required Fields for Processing an Aggregated Authorization with EMV Data {#ft-tech-mtt-emv-agg-auth-reqfields} ============================================================================================================== clientReferenceInformation.code : orderInformation.amountDetails.currency : orderInformation.amountDetails.totalAmount : orderInformation.billTo.address1 : orderInformation.billTo.administrativeArea : orderInformation.billTo.buildingNumber : orderInformation.billTo.country : orderInformation.billTo.district : orderInformation.billTo.email : orderInformation.billTo.firstName : orderInformation.billTo.lastName : orderInformation.billTo.locality : orderInformation.billTo.phoneNumber : orderInformation.billTo.postalCode : paymentInformation.card.expirationMonth : paymentInformation.card.expirationYear : paymentInformation.card.number : paymentInformation.card.type : paymentInformation.initiationChannel : pointOfSaleInformation.cardPresent : pointOfSaleInformation.catLevel : pointOfSaleInformation.emv.cardSequenceNumber : pointOfSaleInformation.emv.tags : pointOfSaleInformation.entryMode : pointOfSaleInformation.terminalCapability : pointOfSaleInformation.terminalPinCapability : pointOfSaleInformation.trackData : processingInformation.authorizationOptions.aggregatedAuthIndicator : processingInformation.authorizationOptions.authIndicator : processingInformation.authorizationOptions.transportationMode : processingInformation.capture : processingInformation.commerceIndicator : processingInformation.industryDataType : Example: Processing an Aggregated Authorization with EMV Data {#ft-tech-mtt-emv-agg-auth-ex-rest} ================================================================================================= Request ``` { "orderInformation": { "billTo": { "address1": "R. Augusta Æ", "address2": "ßloco 01", "buildingNumber": "1024 Metrño4", "locality": "Sáo Paulo", "country": "BR", "district": "Bela Vista Æ", "administrativeArea": "SP", "postalCode": "01310-000", "email": "null@cybersource.com", "firstName": "Júlia", "lastName": "Fernández", "phoneNumber": "999-999-9999" }, "amountDetails": { "totalAmount": "1044.00", "currency": "BRL" } }, "paymentInformation": { "card": { "type": "002", "expirationMonth": "12", "expirationYear": "2026", "number": "5555555555554444" }, "initiationChannel": "00" }, "pointOfSaleInformation": { "cardPresent": "Y", "entryMode": "contact", "terminalCapability": "4", "terminalPinCapability": "6", "trackData": "%B4111111111111111^JONES/JONES ^3112101976110000868000000?;4111111111111111", "emv": { "cardSequenceNumber": "01", "tags": "5F3401019F3303E0F8C8950580800480009F370465B81A3A9F10070601" }, "catLevel": "2" }, "processingInformation": { "capture": false, "commerceIndicator": "retail", "industryDataType": "transit", "authorizationOptions": { "authIndicator": "0", "aggregatedAuthIndicator": "true", "transportationMode": "00" } }, "clientReferenceInformation": { "code": "TC-Vero-2" } } ``` Response to a Successful Request ``` { "_links": { "authReversal": { "method": "POST", "href": "/pts/v2/payments/7696000118397001127451/reversals" }, "self": { "method": "GET", "href": "/pts/v2/payments/7696000118397001127451" }, "capture": { "method": "POST", "href": "/pts/v2/payments/7696000118397001127451/captures" } }, "clientReferenceInformation": { "code": "TC-Vero-2" }, "id": "7696000118397001127451", "orderInformation": { "amountDetails": { "authorizedAmount": "1044.00", "currency": "BRL" } }, "paymentAccountInformation": { "card": { "type": "002" } }, "paymentInformation": { "tokenizedCard": { "type": "002" }, "card": { "type": "002" } }, "pointOfSaleInformation": { "terminalId": "11111111", "emv": { "tags": "9F03060000000000009F0206000000960100820220009F3901078407A00000000310109F370487A1C9E29F360202299F34031F00009F3303E0B0C85F2A0201889F6E04207000009F270180950500000000009F260891BF08455A7DC8B35F3401019A032008079C01009F1B060000003000009F1A0201889F100706020A03A02800" } }, "processorInformation": { "approvalCode": "800000", "networkTransactionId": "345678901876", "transactionId": "345678901876", "responseCode": "00", "avs": { "code": "2" } }, "reconciliationId": "7696000118397001127451", "status": "AUTHORIZED", "submitTimeUtc": "2026-01-28T11:33:38Z" } ``` Deferred Authorization with EMV Data {#ft-tech-mtt-emv-deferred-auth-intro} =========================================================================== This section provides the information you need in order to process a deferred authorization with EMV data. Endpoint {#ft-tech-mtt-emv-deferred-auth-intro_d7e260} ------------------------------------------------------ **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments`{#ft-tech-mtt-emv-deferred-auth-intro_d7e268} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments`{#ft-tech-mtt-emv-deferred-auth-intro_d7e278} Required Fields for Processing an Deferred Authorization with EMV Data {#ft-tech-mtt-emv-deferred-auth-reqfields} ================================================================================================================= clientReferenceInformation.code : orderInformation.amountDetails.currency : orderInformation.amountDetails.totalAmount : orderInformation.billTo.address1 : orderInformation.billTo.address2 : orderInformation.billTo.administrativeArea : orderInformation.billTo.buildingNumber : orderInformation.billTo.country : orderInformation.billTo.district : orderInformation.billTo.email : orderInformation.billTo.firstName : orderInformation.billTo.lastName : orderInformation.billTo.locality : orderInformation.billTo.phoneNumber : orderInformation.billTo.postalCode : paymentInformation.card.expirationMonth : paymentInformation.card.expirationYear : paymentInformation.card.number : paymentInformation.card.type : paymentInformation.initiationChannel : pointOfSaleInformation.cardPresent : pointOfSaleInformation.catLevel : pointOfSaleInformation.emv.cardSequenceNumber : pointOfSaleInformation.emv.tags : pointOfSaleInformation.entryMode : pointOfSaleInformation.terminalCapability : pointOfSaleInformation.terminalPinCapability : pointOfSaleInformation.trackData : processingInformation.authorizationOptions.authIndicator : processingInformation.authorizationOptions.deferredAuthIndicator : processingInformation.authorizationOptions.transportationMode : processingInformation.capture : processingInformation.commerceIndicator : processingInformation.industryDataType : Example: Processing an Deferred Authorization with EMV Data {#ft-tech-mtt-emv-deferred-auth-ex-rest} ==================================================================================================== Request ``` { "orderInformation": { "billTo": { "address1": "R. Augusta Æ", "address2": "ßloco 01", "buildingNumber": "1024 Metrño4", "locality": "Sáo Paulo", "country": "BR", "district": "Bela Vista Æ", "administrativeArea": "SP", "postalCode": "01310-000", "email": "null@cybersource.com", "firstName": "Júlia", "lastName": "Fernández", "phoneNumber": "999-999-9999" }, "amountDetails": { "totalAmount": "1044.00", "currency": "BRL" } }, "paymentInformation": { "card": { "type": "002", "expirationMonth": "12", "expirationYear": "2026", "number": "5555555555554444" }, "initiationChannel": "00" }, "pointOfSaleInformation": { "cardPresent": "Y", "entryMode": "contact", "terminalCapability": "4", "terminalPinCapability": "6", "trackData": "%B4111111111111111^JONES/JONES ^3112101976110000868000000?", "emv": { "cardSequenceNumber": "01", "tags": "5F3401019F3303E0F8C8950580800480009F370465B81A3A9F100706011203" }, "catLevel": "2" }, "processingInformation": { "capture": false, "commerceIndicator": "retail", "industryDataType": "transit", "authorizationOptions": { "authIndicator": "0", "deferredAuthIndicator": "true", "transportationMode": "00" } }, "clientReferenceInformation": { "code": "TC-Vero-2" } } ``` Response to a Successful Request ``` { "_links": { "authReversal": { "method": "POST", "href": "/pts/v2/payments/7696000118397001127451/reversals" }, "self": { "method": "GET", "href": "/pts/v2/payments/7696000118397001127451" }, "capture": { "method": "POST", "href": "/pts/v2/payments/7696000118397001127451/captures" } }, "clientReferenceInformation": { "code": "TC-Vero-2" }, "id": "7696000118397001127451", "orderInformation": { "amountDetails": { "authorizedAmount": "1044.00", "currency": "BRL" } }, "paymentAccountInformation": { "card": { "type": "002" } }, "paymentInformation": { "tokenizedCard": { "type": "002" }, "card": { "type": "002" } }, "pointOfSaleInformation": { "terminalId": "11111111", "emv": { "tags": "9F03060000000000009F0206000000960100820220009F3901078407" } }, "processorInformation": { "approvalCode": "800000", "networkTransactionId": "345678901876", "transactionId": "345678901876", "responseCode": "00", "avs": { "code": "2" } }, "reconciliationId": "7696000118397001127451", "status": "AUTHORIZED", "submitTimeUtc": "2026-01-28T11:33:38Z" } ``` Deferred Sale with EMV Data {#ft-tech-mtt-emv-deferred-sale-intro} ================================================================== This section provides the information you need in order to process a deferred EMV chip contact sale. Endpoint {#ft-tech-mtt-emv-deferred-sale-intro_d7e260} ------------------------------------------------------ **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments`{#ft-tech-mtt-emv-deferred-sale-intro_d7e268} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments`{#ft-tech-mtt-emv-deferred-sale-intro_d7e278} Required Fields for Processing an Deferred Sale with EMV Data {#ft-tech-mtt-emv-deferred-sale-reqfields} ======================================================================================================== clientReferenceInformation.partner.thirdPartyCertificationNumber : clientReferenceInformation.transactionId : orderInformation.amountDetails.currency : orderInformation.amountDetails.totalAmount : orderInformation.billTo.address1 : orderInformation.billTo.address2 : orderInformation.billTo.administrativeArea : orderInformation.billTo.buildingNumber : orderInformation.billTo.country : orderInformation.billTo.district : orderInformation.billTo.email : orderInformation.billTo.firstName : orderInformation.billTo.lastName : orderInformation.billTo.locality : orderInformation.billTo.phoneNumber : orderInformation.billTo.postalCode : paymentInformation.card.expirationMonth : paymentInformation.card.expirationYear : paymentInformation.card.number : paymentInformation.card.type : pointOfSaleInformation.catLevel : pointOfSaleInformation.emv.cardSequenceNumber : pointOfSaleInformation.emv.tags : pointOfSaleInformation.entryMode : pointOfSaleInformation.terminalCapability : pointOfSaleInformation.terminalId : pointOfSaleInformation.terminalPinCapability : pointOfSaleInformation.trackData : processingInformation.authorizationOptions.deferredAuthIndicator : processingInformation.capture : processingInformation.captureOptions.dateToCapture : processingInformation.commerceIndicator : processingInformation.industryDataType : Example: Processing an Deferred Sale with EMV Data {#ft-tech-mtt-emv-deferred-sale-ex-rest} =========================================================================================== Request ``` { "clientReferenceInformation": { "transactionId": "20000565", "partner": { "thirdPartyCertificationNumber": "BPCDRC220403" } }, "processingInformation": { "industryDataType": "transit", "commerceIndicator": "retail", "capture": true, "captureOptions": { "dateToCapture": "0425" }, "authorizationOptions": { "deferredAuthIndicator": "true", } }, "orderInformation": { "amountDetails": { "totalAmount": "10.00", "currency": "BRL" }, "billTo": { "address1": "R. Augusta Æ", "address2": "ßloco 01", "buildingNumber": "1024 Metrño4", "locality": "Sáo Paulo", "country": "BR", "district": "Bela Vista Æ", "administrativeArea": "SP", "postalCode": "01310-000", "email": "null@cybersource.com", "firstName": "Júlia", "lastName": "Fernández", "phoneNumber": "999-999-9999" } }, "paymentInformation": { "card": { "type": "001", "expirationMonth": "12", "expirationYear": "2026", "number": "4111111111111111" } }, "pointOfSaleInformation": { "terminalId": "12345678", "catLevel": "2", "entryMode": "contactless", "terminalCapability": "5", "terminalPinCapability": "0", "emv": { "tags": "5F2A0209768407A00000000310109F360200029F03060000000000009C01005F34010", "cardSequenceNumber": "1" }, "trackData": ";4761XXXXXXXXXXXX=241220119058254?" } } ``` Response to a Successful Request ``` { "_links": { "authReversal": { "method": "POST", "href": "/pts/v2/payments/7696000118397001127451/reversals" }, "self": { "method": "GET", "href": "/pts/v2/payments/7696000118397001127451" }, "capture": { "method": "POST", "href": "/pts/v2/payments/7696000118397001127451/captures" } }, "clientReferenceInformation": { "code": "TC-Vero-2" }, "id": "7696000118397001127451", "orderInformation": { "amountDetails": { "authorizedAmount": "1044.00", "currency": "BRL" } }, "paymentAccountInformation": { "card": { "type": "002" } }, "paymentInformation": { "tokenizedCard": { "type": "002" }, "card": { "type": "002" } }, "pointOfSaleInformation": { "terminalId": "11111111", "emv": { "tags": "9F03060000000000009F0206000000960100820220009F3901078407" } }, "processorInformation": { "approvalCode": "800000", "networkTransactionId": "345678901876", "transactionId": "345678901876", "responseCode": "00", "avs": { "code": "2" } }, "reconciliationId": "7696000118397001127451", "status": "AUTHORIZED", "submitTimeUtc": "2026-01-28T11:33:38Z" } ``` Authorization Reversal {#ft-tech-mtt-emv-auth-reversal-intro} ============================================================= This section provides the information you need in order to process an authorization reversal. Endpoint {#ft-tech-mtt-emv-auth-reversal-intro_d7e260} ------------------------------------------------------ **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments`{#ft-tech-mtt-emv-auth-reversal-intro_d7e268} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments`{#ft-tech-mtt-emv-auth-reversal-intro_d7e278} Required Fields for Processing an Authorization Reversal {#ft-tech-mtt-emv-auth-reversal-reqfields} =================================================================================================== clientReferenceInformation.code : orderInformation.amountDetails.currency : reversalInformation.amountDetails.totalAmount : Example: Processing an Authorization Reversal {#ft-tech-mtt-emv-auth-reversal-ex-rest} ====================================================================================== Request ``` { "clientReferenceInformation" : { "code" : "10000568" }, "orderInformation" : { "amountDetails" : { "currency" : "brl" } }, "reversalInformation" : { "amountDetails" : { "totalAmount" : "1044.00" } } } ``` Response to a Successful Request ``` { "_links": { "self": { "method": "GET", "href": "/pts/v2/reversals/7696008113557001627451" } }, "clientReferenceInformation": { "code": "10000568" }, "id": "7696008113557001627451", "orderInformation": { "amountDetails": { "currency": "brl" } }, "processorInformation": { "responseCode": "00" }, "reconciliationId": "7696008113557001627451", "reversalAmountDetails": { "reversedAmount": "1044.00", "currency": "brl" }, "status": "REVERSED", "submitTimeUtc": "2026-01-28T11:46:53Z" } ``` Tap-Initiated Sale for Debt Recovery {#ft-tech-mtt-debt-recovery-intro} ======================================================================= This section provides the information you need in order to process a tap-initiated sale for debt recovery. Endpoint {#ft-tech-mtt-debt-recovery-intro_d7e260} -------------------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments`{#ft-tech-mtt-debt-recovery-intro_d7e268} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments`{#ft-tech-mtt-debt-recovery-intro_d7e278} Required Fields for Tap-Initiated Sale for Debt Recovery {#ft-tech-mtt-debt-recovery-reqfields} =============================================================================================== clientReferenceInformation.code : clientReferenceInformation.partner.solutionId : clientReferenceInformation.partner.thirdPartyCertificationNumber : clientReferenceInformation.transactionId : orderInformation.amountDetails.currency : orderInformation.amountDetails.totalAmount : orderInformation.billTo.address1 : orderInformation.billTo.address2 : orderInformation.billTo.administrativeArea : orderInformation.billTo.buildingNumber : orderInformation.billTo.country : orderInformation.billTo.district : orderInformation.billTo.email : orderInformation.billTo.firstName : orderInformation.billTo.lastName : orderInformation.billTo.locality : orderInformation.billTo.phoneNumber : orderInformation.billTo.postalCode : paymentInformation.card.expirationMonth : paymentInformation.card.expirationYear : paymentInformation.card.number : paymentInformation.card.type : paymentInformation.initiationChannel : pointOfSaleInformation.cardPresent : pointOfSaleInformation.catLevel : pointOfSaleInformation.emv.cardSequenceNumber : pointOfSaleInformation.emv.tags : pointOfSaleInformation.entryMode : pointOfSaleInformation.serviceCode : pointOfSaleInformation.terminalCapability : pointOfSaleInformation.terminalId : pointOfSaleInformation.terminalPinCapability : pointOfSaleInformation.trackData : processingInformation.authorizationOptions.authIndicator : processingInformation.authorizationOptions.debtRecoveryIndicator : processingInformation.authorizationOptions.transportationMode : processingInformation.capture : processingInformation.captureOptions.dateToCapture : processingInformation.commerceIndicator : processingInformation.industryDataType : Example: Processing a Tap-Initiated Sale for Debt Recovery {#ft-tech-mtt-debt-recovery-ex-rest} =============================================================================================== Request ``` { "orderInformation": { "billTo": { "address1": "R. Augusta Æ", "address2": "ßloco 01", "buildingNumber": "1024 Metrño4", "locality": "Sáo Paulo", "country": "BR", "district": "Bela Vista Æ", "administrativeArea": "SP", "postalCode": "01310-000", "email": "null@cybersource.com", "firstName": "Júlia", "lastName": "Fernández", "phoneNumber": "999-999-9999" }, "amountDetails": { "totalAmount": "10.00", "currency": "BRL" } }, "paymentInformation": { "card": { "type": "002", "expirationMonth": "12", "expirationYear": "2026", "number": "5555555555554444" }, "initiationChannel": "00" }, "pointOfSaleInformation": { "cardPresent": "Y", "entryMode": "contactless", "terminalId": "12345678", "terminalCapability": "5", "terminalPinCapability": "0", "trackData": "%B5555555555554444^JONES/JONES ^3112101976110000868000000", "emv": { "cardSequenceNumber": "01", "tags": "5F3401019F3303E0F8C8950580800480009F370465B81A3A9F1007" }, "serviceCode": "201", "catLevel": "2" }, "processingInformation": { "capture": true, "commerceIndicator": "retail", "industryDataType": "transit", "captureOptions": { "dateToCapture": "0425" }, "authorizationOptions": { "authIndicator": "1", "debtRecoveryIndicator": "true", "transportationMode": "00" } }, "clientReferenceInformation": { "code": "10000685MC", "transactionId": "20000685MC", "partner": { "thirdPartyCertificationNumber": "BPCDRC220403", "solutionId": "548UHQ8Z" } } } ``` Response to a Successful Request ``` { "_links": { "void": { "method": "POST", "href": "/pts/v2/payments/7696015712597001827451/voids" }, "self": { "method": "GET", "href": "/pts/v2/payments/7696015712597001827451" } }, "clientReferenceInformation": { "code": "10000685MC", "partner": { "solutionId": "548UHQ8Z" }, "transactionId": "20000685MC" }, "id": "7696015712597001827451", "orderInformation": { "amountDetails": { "totalAmount": "10.00", "authorizedAmount": "10.00", "currency": "BRL" } }, "paymentAccountInformation": { "card": { "type": "002" } }, "paymentInformation": { "tokenizedCard": { "type": "002" }, "card": { "type": "002" } }, "pointOfSaleInformation": { "terminalId": "11111111", "emv": { "tags": "9F03060000000000009F0206000000960100820220009F3901078407A00000000310109F370487A1C9E29F360202299F34031F00009F3303E0B0C85F2A0201889F6E04207000009F270180950500000000009F260891BF08455A7DC8B35F3401019A032008079C01009F1B060000003000009F1A0201889F100706020A03A02800" } }, "processorInformation": { "approvalCode": "800000", "networkTransactionId": "345678901876", "transactionId": "345678901876", "responseCode": "00", "avs": { "code": "2" } }, "reconciliationId": "7696015712597001827451", "status": "AUTHORIZED", "submitTimeUtc": "2026-01-28T11:59:33Z" } ```