Authorize - Regional API GetNet

Splitting a Transaction Across Multiple Cards

This endpoint allows you to authorize a combined payment using multiple cards. It is typically used when a buyer wishes to split the total amount across two or more payment methods.

Usage Scenarios:
- Offering flexibility to the customer in payment options.
- Handling split transactions for marketplaces or platforms.

Notes:
- Only card-based payments are allowed. APMs like PIX and Boleto are not supported.
- This flow is valid only for card-not-present (e-commerce) scenarios.
- The field combined_id in the response is used to track the overall transaction.
- Each card must be represented as an object inside the payments array.

请求参数

Authorization

OAuth 2.0

Client Credentials

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Token URL: https://api.globalgetnet.com/authentication/oauth2/access_token

OAuth 2.0

Client Credentials

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Token URL: https://api.pre.globalgetnet.com/authentication/oauth2/access_token

OAuth 2.0

Client Credentials

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Token URL: https://api-sbx.globalgetnet.com/authentication/oauth2/access_token

Scopes:

digital-platform:gateway-api-Read and write access

Header 参数

Body 参数application/json必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/dpm/payments-gwproxy/v2/payments/combined' \
--header 'x-transaction-channel-entry;' \
--header 'Content-Type: application/json' \
--data '{
    "request_id": "daac03dc-73db-453f-9bea-b1391669d5d3",
    "order_id": "ORDER-10187383",
    "data": {
        "amount": 8900,
        "currency": "BRL",
        "customer_id": "string",
        "payments": [
            {
                "idempotency_key": "63c7f8ee-51a6-470d-bb76-ef762b62bfb7",
                "payment_id": "2c341d28-491b-4cf8-aec7-eeb60136b7a5",
                "amount": 8900,
                "payment_method": "CREDIT",
                "save_card_data": false,
                "transaction_type": "FULL",
                "number_installments": 1,
                "soft_descriptor": "MEUECOMM*ORDER10187383",
                "dynamic_mcc": 1234,
                "card": {
                    "number": "4013790001234569",
                    "expiration_month": "09",
                    "expiration_year": 30,
                    "cardholder_name": "Roland Deschain",
                    "security_code": 517,
                    "brand": "MASTERCARD",
                    "number_token": "e71084449bc70e344f77d4c382704ea2868b5e9775dced7ffcd40b3f66b167f51e352a2f289b518a11180c81478dfbdbeffd8a41f0b34564f2f0e41be8a88e11",
                    "entry_mode": "string",
                    "seq_number": "string",
                    "pin_block": "A0B6BA8D53C8D3C3",
                    "pin_key_id": "string",
                    "ksn": "BC756011020000400001",
                    "emv": "6F1A840E315041592E5359532E4444463031A5088801025F2D02656E",
                    "aid": "string",
                    "cardholder_verification_method": "offline_pin",
                    "aggregator": "siscard",
                    "service_code": {
                        "interchange": "international",
                        "chip": true,
                        "authorization_process": "normal_rules",
                        "pin_required": "required",
                        "range_of_services": "no_restrictions"
                    },
                    "track_1": "%B1234567890123445^PADILLA/L. ^99011X100000*000000000XXX000000?*",
                    "track_2": "4013790001234569=301220111379456001"
                },
                "tokenization": {
                    "type": "UCAF",
                    "cryptogram": "0006010865799300000620111679930000000000",
                    "eci": "00",
                    "requestor_id": 1234567
                },
                "wallet": {
                    "type": "01",
                    "id": "101",
                    "merchant_id": "327",
                    "fund_transfer": {
                        "pay_action": "FT",
                        "receiver": {
                            "account_number": "9999999999999995",
                            "account_type": "00",
                            "first_name": "Jane",
                            "middle_name": "T",
                            "last_name": "Smith",
                            "addr_street": "1 Main ST",
                            "addr_city": "SAO PAULO",
                            "addr_state": "SP",
                            "addr_country": "BRA",
                            "addr_postal_code": "1408000",
                            "nationality": "BRA",
                            "phone": "5511977778888",
                            "date_of_birth": "19901230",
                            "id_type": "00",
                            "id_num": "12345678900000"
                        }
                    },
                    "capture_type": "0",
                    "ticket_number": "0",
                    "capture_channel": "pos",
                    "identification": "Santander",
                    "plans": "01",
                    "sub_plan": "01"
                },
                "xid": "test",
                "ucaf": "string",
                "eci": "00",
                "tdsdsxid": "string",
                "tdsver": "2.1.0",
                "is_pre_paid": true,
                "network_token": "1b110aaa71934ae492bff48baab9af81",
                "payment_tag": "string",
                "billing_address": {
                    "street": "string",
                    "number": "string",
                    "district": "string",
                    "city": "string",
                    "state": "string",
                    "country": "string",
                    "postal_code": "string",
                    "complement": "string",
                    "type": "RESIDENCIAL"
                },
                "installment": {
                    "quote_id": "06f256c8-1bbf-42bf-93b4-ce2041bfb87e",
                    "schema": "plan_ahora",
                    "type": "00",
                    "code": "00",
                    "number": 2
                },
                "cross_border_data": {
                    "first_name": "John",
                    "last_name": "da Silva",
                    "type": "INDIVIDUAL",
                    "document_number": "string",
                    "email": "string"
                }
            }
        ],
        "sub_merchant": {
            "business_name": "Company Ltd",
            "foreign_type": "F, P or D",
            "identification_code": 9058345,
            "document_type": "CNPJ",
            "document_number": 77415914000148,
            "address": "Dark Tower, 207",
            "city": "Sao Paulo",
            "state": "SP",
            "postal_code": 90520000
        },
        "additional_data": {
            "property1": {},
            "property2": {}
        }
    },
    "additional_data": {
        "property1": {},
        "property2": {}
    }
}'

返回响应

🟢200

application/json

Transaction executed successfully.

Bodyapplication/json

示例

{
    "seller_id": "9406df6c-3100-49ba-b4df-d81c1ad8a62b",
    "request_id": "daac03dc-73db-453f-9bea-b1391669d5d3",
    "order_id": "ORDER-10187383",
    "amount": 8900,
    "combined_id": "66f36211-3a61-41fa-8747-052c451e89ad",
    "payments": [
        {
            "idempotency_key": "63c7f8ee-51a6-470d-bb76-ef762b62bfb7",
            "payment_id": "2c341d28-491b-4cf8-aec7-eeb60136b7a5",
            "status": "string",
            "payment_method": "CREDIT",
            "received_at": "2020-06-30T18:32:51.222Z",
            "transaction_id": "3729756321501820",
            "original_transaction_id": "6534812321501821",
            "authorized_at": "2020-06-30T18:32:51.815Z",
            "reason_code": "00",
            "reason_message": "TRANSACTION EXECUTED SUCCESSFULLY",
            "acquirer": "GETNET",
            "soft_descriptor": "MEUECOMM*ORDER10187383",
            "brand": "MASTERCARD",
            "authorization_code": "017060",
            "acquirer_transaction_id": "000152147981",
            "eci": "07",
            "payment_received_timestamp": "2019-08-24T14:15:22.123Z",
            "card_id": "e8ad2ae4-9e3e-4532-998f-1a5a11e56e58",
            "merchant_advice_code": "string",
            "amount": 8900,
            "currency": "BRL"
        }
    ]
}

🟠400

🟠401

🟠403

🟠404

🟠422

🟠429

🔴500

🔴503

🔴504