Create - Authorize - Regional API GetNet

Create a Payment Transaction

The Create Payment endpoint allows merchants to initiate a payment transaction
using credit or debit cards, as well as alternative payment methods. This request processes the transaction and returns
a response indicating its status. Moreover, this operation also supports installment payments.

Notes:

Some transactions may require additional steps, such as authentication or tokenization.

An idempotency key must be included to prevent duplicate transactions.

Always validate the payment response to confirm the transaction was successfully processed.

To specify the type of transaction, you must specify the type within the data.payment.payment_method field.

For transactions in Uruguay (UY):
IVA: Básico 22%, Mínimo 10%, Exento 0%.
Legislation: The following laws do not apply to these transactions Law 19.210, Law 17.934, and Law 18.999._
Law 18.999.

请求参数

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必填

示例

{
    "idempotency_key": "63c7f8ee-51a6-470d-bb76-ef762b62bfb7",
    "request_id": "daac03dc-73db-453f-9bea-b1391669d5d3",
    "order_id": "ORDER-10187383",
    "data": {
        "amount": 118708,
        "currency": "BRL",
        "customer_id": "test",
        "payment": {
            "payment_id": "173f9e8d-4e0b-4503-8016-5cdafba89bee",
            "payment_method": "CREDIT",
            "save_card_data": false,
            "transaction_type": "FULL",
            "number_installments": 1,
            "soft_descriptor": "LOJA*TESTE*COMPRA-123",
            "dynamic_mcc": 1799,
            "card": {
                "number": "5155901222260000",
                "expiration_month": "09",
                "expiration_year": "30",
                "cardholder_name": "Roland Deschain",
                "security_code": "517",
                "brand": "Visa",
                "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": "TAVV",
                "cryptogram": "0006010865799300000620111679930000000000",
                "eci": "00",
                "requestor_id": "1234567"
            },
            "wallet": {
                "type": "55",
                "id": "000",
                "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"
                    }
                }
            },
            "xid": "test",
            "ucaf": "string",
            "eci": "00",
            "tdsdsxid": "string",
            "tdsver": "2.1.0",
            "terminal": {
                "terminal_number": "string"
            }
        },
        "additional_data": {
            "url": "https://site.getnet.com.br",
            "device": {
                "device_id": "63c7f8ee-51a6-470d-bb76-ef762b62bfb7"
            },
            "customer": {
                "document_number": "77415914000148"
            }
        },
        "sub_merchant": {
            "business_name": "Company Ltd",
            "foreign_type": "F",
            "identification_code": "9058345",
            "document_type": "CNPJ",
            "document_number": "77415914000148",
            "address": "Dark Tower, 207",
            "city": "Sao Paulo",
            "state": "SP",
            "postal_code": "90520000"
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/dpm/payments-gwproxy/v2/payments' \
--header 'x-transaction-channel-entry;' \
--header 'Content-Type: application/json' \
--data '{
    "idempotency_key": "63c7f8ee-51a6-470d-bb76-ef762b62bfb7",
    "request_id": "daac03dc-73db-453f-9bea-b1391669d5d3",
    "order_id": "ORDER-10187383",
    "data": {
        "amount": 118708,
        "currency": "BRL",
        "customer_id": "test",
        "payment": {
            "payment_id": "173f9e8d-4e0b-4503-8016-5cdafba89bee",
            "payment_method": "CREDIT",
            "save_card_data": false,
            "transaction_type": "FULL",
            "number_installments": 1,
            "soft_descriptor": "LOJA*TESTE*COMPRA-123",
            "dynamic_mcc": 1799,
            "card": {
                "number": "5155901222260000",
                "expiration_month": "09",
                "expiration_year": "30",
                "cardholder_name": "Roland Deschain",
                "security_code": "517",
                "brand": "Visa",
                "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": "TAVV",
                "cryptogram": "0006010865799300000620111679930000000000",
                "eci": "00",
                "requestor_id": "1234567"
            },
            "wallet": {
                "type": "55",
                "id": "000",
                "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"
                    }
                }
            },
            "xid": "test",
            "ucaf": "string",
            "eci": "00",
            "tdsdsxid": "string",
            "tdsver": "2.1.0",
            "terminal": {
                "terminal_number": "string"
            }
        },
        "additional_data": {
            "url": "https://site.getnet.com.br",
            "device": {
                "device_id": "63c7f8ee-51a6-470d-bb76-ef762b62bfb7"
            },
            "customer": {
                "document_number": "77415914000148"
            }
        },
        "sub_merchant": {
            "business_name": "Company Ltd",
            "foreign_type": "F",
            "identification_code": "9058345",
            "document_type": "CNPJ",
            "document_number": "77415914000148",
            "address": "Dark Tower, 207",
            "city": "Sao Paulo",
            "state": "SP",
            "postal_code": "90520000"
        }
    }
}'

返回响应

🟢200

application/json

Transaction executed successfully.

Bodyapplication/json

示例

{
    "idempotency_key": "63c7f8ee-51a6-470d-bb76-ef762b62bfb7",
    "seller_id": "e0ed6f00-fdc5-46d6-9557-6a2cac641b09",
    "payment_id": "173f9e8d-4e0b-4503-8016-5cdafba89bee",
    "order_id": "ORDER-10187383",
    "amount": 118708,
    "currency": "BRL",
    "status": "APPROVED",
    "payment_method": "CREDIT",
    "received_at": "2025-10-24T09:41:05.146Z",
    "transaction_id": "MCC20502G2040",
    "original_transaction_id": "MCC20502G2040",
    "authorized_at": "2025-10-24T09:41:05.146Z",
    "reason_code": "00",
    "reason_message": "captured",
    "acquirer": "GETNET",
    "soft_descriptor": "LOJA*TESTE*COMPRA-123",
    "brand": "MASTERCARD",
    "authorization_code": "502050",
    "acquirer_transaction_id": "506010104010102010603010"
}

🟠400

🟠401

🟠403

🟠404

🟠422

🟠429

🔴500

🔴503

🔴504