Getnet Global API

https://docs.globalgetnet.com/en/products/online-payments/regional-api
Admin
Getnet Global API is a unified REST API that enables omnichannel payment processing for both online...
Tokens:20,399
Snippets:89
Trust Score:6.9
Update:6 months ago
Show doc for...
Tokens:
Raw
### Payment Response Structure

Source: https://docs.globalgetnet.com/en/products/online-payments/regional-api?doc=create-single-step-payment

Example of a successful payment response where the status is set to APPROVED.

```json
{  "idempotency_key": "63c7f8ee-51a6-470d-bb76-ef762b62bfb9",  "seller_id": "e0ed6f00-fdc5-46d6-9557-6a2cac641b09",  "payment_id": "053de7f9-3725-437b-bdfc-bbf3ed0acb75",  "order_id": "ORDER-10187383",  "amount": 118708,  "currency": "BRL",  "status": "APPROVED",  "payment_method": "CREDIT",  "received_at": "2025-10-31T13:40:47.382Z",  "transaction_id": "MCC50205G1020",  "original_transaction_id": "MCC50205G1020",  "authorized_at": "2025-10-31T13:40:47.382Z",  "reason_code": "00",  "reason_message": "captured",  "acquirer": "GETNET",  "soft_descriptor": "LOJA*TESTE*COMPRA-123",  "brand": "MASTERCARD",  "authorization_code": "204050",  "acquirer_transaction_id": "405030304060404030501060" }
```

```json
{  "idempotency_key": "63c7f8ee-51a6-470d-bb76-ef762b62bfb9",  "seller_id": "e0ed6f00-fdc5-46d6-9557-6a2cac641b09",  "payment_id": "053de7f9-3725-437b-bdfc-bbf3ed0acb75",  "order_id": "ORDER-10187383",  "amount": 118708,  "currency": "BRL",  "status": "APPROVED",  "payment_method": "CREDIT",  "received_at": "2025-10-31T13:40:47.382Z",  "transaction_id": "MCC50205G1020",  "original_transaction_id": "MCC50205G1020",  "authorized_at": "2025-10-31T13:40:47.382Z",  "reason_code": "00",  "reason_message": "captured",  "acquirer": "GETNET",  "soft_descriptor": "LOJA*TESTE*COMPRA-123",  "brand": "MASTERCARD",  "authorization_code": "204050",  "acquirer_transaction_id": "405030304060404030501060" }
```

--------------------------------

### Payment Response Structure

Source: https://docs.globalgetnet.com/en/products/online-payments/regional-api?doc=create-pre-authorized-payment

Example of a successful payment authorization response returned by the API.

```json
{  "idempotency_key": "13c7f8ee-51a6-470d-bb76-ef762b62bfb7",  "seller_id": "54f88e68-7764-4e87-8830-756b1e2c02f8",  "payment_id": "d36887d0-53ec-4c36-b731-9bbeca18fcd2",  "order_id": "123order2",  "amount": 118708,  "currency": "CLP",  "status": "AUTHORIZED",  "payment_method": "CREDIT_PRE_AUTHORIZATION",  "received_at": "2025-08-12T20:46:26.713Z",  "transaction_id": "MCC30105G5020",  "original_transaction_id": "MCC30105G5020",  "authorized_at": "2025-08-12T20:46:26.713Z",  "reason_code": "00",  "reason_message": "authorized",  "acquirer": "GETNET",  "soft_descriptor": "LOJA*TESTE*COMPRA-123",  "brand": "MASTERCARD",  "authorization_code": "604020",  "acquirer_transaction_id": "204050301040206020503010" }
```

--------------------------------

### Payment Response (Approved)

Source: https://docs.globalgetnet.com/en/products/online-payments/regional-api?doc=create-single-step-payment&section=a9jrdctr742wx72m2g332q2r

This is an example of a successful payment response from the GlobalGetNet API, indicating the transaction was approved.

```json
{
  "idempotency_key": "63c7f8ee-51a6-470d-bb76-ef762b62bfb9",
  "seller_id": "e0ed6f00-fdc5-46d6-9557-6a2cac641b09",
  "payment_id": "053de7f9-3725-437b-bdfc-bbf3ed0acb75",
  "order_id": "ORDER-10187383",
  "amount": 118708,
  "currency": "BRL",
  "status": "APPROVED",
  "payment_method": "CREDIT",
  "received_at": "2025-10-31T13:40:47.382Z",
  "transaction_id": "MCC50205G1020",
  "original_transaction_id": "MCC50205G1020",
  "authorized_at": "2025-10-31T13:40:47.382Z",
  "reason_code": "00",
  "reason_message": "captured",
  "acquirer": "GETNET",
  "soft_descriptor": "LOJA*TESTE*COMPRA-123",
  "brand": "MASTERCARD",
  "authorization_code": "204050",
  "acquirer_transaction_id": "405030304060404030501060"
}
```

```json
{
  "idempotency_key": "63c7f8ee-51a6-470d-bb76-ef762b62bfb9",
  "seller_id": "e0ed6f00-fdc5-46d6-9557-6a2cac641b09",
  "payment_id": "053de7f9-3725-437b-bdfc-bbf3ed0acb75",
  "order_id": "ORDER-10187383",
  "amount": 118708,
  "currency": "BRL",
  "status": "APPROVED",
  "payment_method": "CREDIT",
  "received_at": "2025-10-31T13:40:47.382Z",
  "transaction_id": "MCC50205G1020",
  "original_transaction_id": "MCC50205G1020",
  "authorized_at": "2025-10-31T13:40:47.382Z",
  "reason_code": "00",
  "reason_message": "captured",
  "acquirer": "GETNET",
  "soft_descriptor": "LOJA*TESTE*COMPRA-123",
  "brand": "MASTERCARD",
  "authorization_code": "204050",
  "acquirer_transaction_id": "405030304060404030501060"
}
```

--------------------------------

### Initiate Payment Request

Source: https://docs.globalgetnet.com/en/products/online-payments/regional-api?doc=create-pre-authorized-payment

Use this cURL command to send a payment request to the Getnet sandbox environment. Ensure the authorization header is populated with a valid bearer token.

```bash
curl --request POST \
  --url https://api-sbx.globalgetnet.com/dpm/payments-gwproxy/v2/payments \
  --header 'authorization: Bearer ' \
  --header 'content-type: application/json' \
  --header 'x-seller-id: 54f88e68-7764-4e87-8830-756b1e2c02f8' \
  --header 'x-transaction-channel-entry: XX' \
  --data '{   "idempotency_key": "63c7f8ee-51a6-470d-bb76-ef762b62bfb7",   "request_id": "daac03dc-73db-453f-9bea-b1391669d5d3",   "order_id": "order123",   "data": {     "amount": 118708,     "currency": "BRL",     "customer_id": "test",     "customer": {       "first_name": "John",       "last_name": "Doe",       "email": "john.doe@example.com",       "document_type": "CPF",       "document_number": "12345678900",       "phone_number": "+5511999999999",       "billing_address": {         "street": "Av. Paulista",         "number": "1000",         "complement": "Apto 101",         "district": "Bela Vista",         "city": "São Paulo",         "state": "SP",         "country": "BR",         "postal_code": "01310-100"       }     },     "payment": {       "payment_method": "CREDIT_PRE_AUTHORIZATION",       "save_card_data": false,       "transaction_type": "FULL",       "number_installments": 1,       "soft_descriptor": "LOJA*TESTE*COMPRA-123",       "dynamic_mcc": 1799,       "card": {         "number": "5155901222260000",         "expiration_month": "05",         "expiration_year": "25",         "cardholder_name": "CARD HOLDER",         "security_code": "282"       }     },     "additional_data": {       "device": {         "ip_address": "192.168.1.1",         "device_id": "63c7f8ee-51a6-470d-bb76-ef762b62bfb7",         "finger_print": "1a2b3c4d5e6f7g8h9i0j"       }     }   } }'
```

--------------------------------

### Installments Operations API

Source: https://docs.globalgetnet.com/en/products/online-payments/regional-api/swagger

Endpoint for managing installment payment quotes.

```APIDOC
## POST /dpm/payments-gwproxy/v2/payments/quotes

### Description
Provides quotes for installment payments.

### Method
POST

### Endpoint
/dpm/payments-gwproxy/v2/payments/quotes

### Request Body
(Details not provided in source text)

### Response
(Details not provided in source text)
```

--------------------------------

### Make a Payment Request

Source: https://docs.globalgetnet.com/en/products/online-payments/regional-api?doc=create-single-step-payment&section=a9jrdctr742wx72m2g332q2r

Use this cURL command to send a payment request to the GlobalGetNet sandbox API. Ensure all headers and the JSON payload are correctly formatted.

```bash
curl --request POST \ --url https://api-sbx.globalgetnet.com/dpm/payments-gwproxy/v2/payments \ --header 'authorization: Bearer ' \ --header 'content-type: application/json' \ --header 'x-seller-id: 54f88e68-7764-4e87-8830-756b1e2c02f8' \ --header 'x-transaction-channel-entry: XX' \ --data'{
  "idempotency_key": "63c7f8ee-51a6-470d-bb76-ef762b62bfb9",
  "request_id": "daac03dc-73db-453f-9bea-b1391669d5d3",
  "order_id": "ORDER-10187383",
  "data": {
    "amount": 118708,
    "currency": "BRL",
    "customer_id": "test",
    "customer": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "john.doe@example.com",
      "document_type": "CPF",
      "document_number": "12345678900",
      "phone_number": "+5511999999999",
      "billing_address": {
        "street": "Av. Paulista",
        "number": "1000",
        "complement": "Apto 101",
        "district": "Bela Vista",
        "city": "São Paulo",
        "state": "SP",
        "country": "BR",
        "postal_code": "01310-100"
      }
    },
    "payment": {
      "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": "Card Holder",
        "security_code": "517"
      }
    },
    "additional_data": {
      "device": {
        "ip_address": "192.168.1.1",
        "device_id": "63c7f8ee-51a6-470d-bb76-ef762b62bfb9",
        "finger_print": "1a2b3c4d5e6f7g8h9i0j"
      }
    }
  }
}'
```

--------------------------------

### Initiate Payment Request

Source: https://docs.globalgetnet.com/en/products/online-payments/regional-api?doc=create-single-step-payment

Use this cURL command to send a POST request to the payments endpoint. Ensure the authorization header is populated with a valid Bearer token.

```bash
curl --request POST \
  --url https://api-sbx.globalgetnet.com/dpm/payments-gwproxy/v2/payments \
  --header 'authorization: Bearer ' \
  --header 'content-type: application/json' \
  --header 'x-seller-id: 54f88e68-7764-4e87-8830-756b1e2c02f8' \
  --header 'x-transaction-channel-entry: XX' \
   --data'{   "idempotency_key": "63c7f8ee-51a6-470d-bb76-ef762b62bfb9",   "request_id": "daac03dc-73db-453f-9bea-b1391669d5d3",   "order_id": "ORDER-10187383",   "data": {     "amount": 118708,     "currency": "BRL",     "customer_id": "test",     "customer": {       "first_name": "John",       "last_name": "Doe",       "email": "john.doe@example.com",       "document_type": "CPF",       "document_number": "12345678900",       "phone_number": "+5511999999999",       "billing_address": {         "street": "Av. Paulista",         "number": "1000",         "complement": "Apto 101",         "district": "Bela Vista",         "city": "São Paulo",         "state": "SP",         "country": "BR",         "postal_code": "01310-100"       }     },     "payment": {       "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": "Card Holder",         "security_code": "517"       }     },     "additional_data": {       "device": {         "ip_address": "192.168.1.1",         "device_id": "63c7f8ee-51a6-470d-bb76-ef762b62bfb9",         "finger_print": "1a2b3c4d5e6f7g8h9i0j"       }     }   } }'
```

```bash
curl --request POST \
  --url https://api-sbx.globalgetnet.com/dpm/payments-gwproxy/v2/payments \
  --header 'authorization: Bearer ' \
  --header 'content-type: application/json' \
  --header 'x-seller-id: 54f88e68-7764-4e87-8830-756b1e2c02f8' \
  --header 'x-transaction-channel-entry: XX' \
   --data'{   "idempotency_key": "63c7f8ee-51a6-470d-bb76-ef762b62bfb9",   "request_id": "daac03dc-73db-453f-9bea-b1391669d5d3",   "order_id": "ORDER-10187383",   "data": {     "amount": 118708,     "currency": "BRL",     "customer_id": "test",     "customer": {       "first_name": "John",       "last_name": "Doe",       "email": "john.doe@example.com",       "document_type": "CPF",       "document_number": "12345678900",       "phone_number": "+5511999999999",       "billing_address": {         "street": "Av. Paulista",         "number": "1000",         "complement": "Apto 101",         "district": "Bela Vista",         "city": "São Paulo",         "state": "SP",         "country": "BR",         "postal_code": "01310-100"       }     },     "payment": {       "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": "Card Holder",         "security_code": "517"       }     },     "additional_data": {       "device": {         "ip_address": "192.168.1.1",         "device_id": "63c7f8ee-51a6-470d-bb76-ef762b62bfb9",         "finger_print": "1a2b3c4d5e6f7g8h9i0j"       }     }   } }'
```

--------------------------------

### POST /dpm/payments-gwproxy/v2/payments

Source: https://docs.globalgetnet.com/en/products/online-payments/regional-api?doc=create-pre-authorized-payment

Initiates a payment transaction through the GlobalGetNet payment gateway. This endpoint is used to process various payment methods, including credit card pre-authorization.

```APIDOC
## POST /dpm/payments-gwproxy/v2/payments

### Description
Initiates a payment transaction through the GlobalGetNet payment gateway. This endpoint is used to process various payment methods, including credit card pre-authorization.

### Method
POST

### Endpoint
https://api-sbx.globalgetnet.com/dpm/payments-gwproxy/v2/payments

### Headers
- **authorization** (string) - Required - Bearer token for authentication.
- **content-type** (string) - Required - Specifies the content type, typically 'application/json'.
- **x-seller-id** (string) - Required - The unique identifier for the seller.
- **x-transaction-channel-entry** (string) - Required - Identifier for the transaction channel entry.

### Request Body
- **idempotency_key** (string) - Required - A unique key to ensure idempotency of the request.
- **request_id** (string) - Required - A unique identifier for the request.
- **order_id** (string) - Required - The identifier for the order.
- **data** (object) - Required - Contains the details of the payment.
  - **amount** (integer) - Required - The transaction amount in the smallest currency unit.
  - **currency** (string) - Required - The currency code (e.g., 'BRL').
  - **customer_id** (string) - Optional - The identifier for the customer.
  - **customer** (object) - Optional - Customer details.
    - **first_name** (string) - Required - Customer's first name.
    - **last_name** (string) - Required - Customer's last name.
    - **email** (string) - Required - Customer's email address.
    - **document_type** (string) - Required - Type of customer document (e.g., 'CPF').
    - **document_number** (string) - Required - Customer's document number.
    - **phone_number** (string) - Optional - Customer's phone number.
    - **billing_address** (object) - Optional - Customer's billing address.
      - **street** (string) - Required - Street name.
      - **number** (string) - Required - Building number.
      - **complement** (string) - Optional - Apartment or unit number.
      - **district** (string) - Required - Neighborhood.
      - **city** (string) - Required - City name.
      - **state** (string) - Required - State or province code.
      - **country** (string) - Required - Country code.
      - **postal_code** (string) - Required - Postal code.
  - **payment** (object) - Required - Payment details.
    - **payment_method** (string) - Required - The payment method (e.g., 'CREDIT_PRE_AUTHORIZATION').
    - **save_card_data** (boolean) - Optional - Whether to save card data.
    - **transaction_type** (string) - Required - Type of transaction (e.g., 'FULL').
    - **number_installments** (integer) - Optional - Number of installments.
    - **soft_descriptor** (string) - Optional - Soft descriptor for the transaction.
    - **dynamic_mcc** (integer) - Optional - Dynamic Merchant Category Code.
    - **card** (object) - Required if payment_method is card-related - Card details.
      - **number** (string) - Required - Card number.
      - **expiration_month** (string) - Required - Card expiration month (MM).
      - **expiration_year** (string) - Required - Card expiration year (YY).
      - **cardholder_name** (string) - Required - Name of the cardholder.
      - **security_code** (string) - Required - Card security code (CVV).
  - **additional_data** (object) - Optional - Additional data for the transaction.
    - **device** (object) - Optional - Device information.
      - **ip_address** (string) - Optional - IP address of the device.
      - **device_id** (string) - Optional - Device identifier.
      - **finger_print** (string) - Optional - Device fingerprint.

### Request Example
```json
{
  "idempotency_key": "63c7f8ee-51a6-470d-bb76-ef762b62bfb7",
  "request_id": "daac03dc-73db-453f-9bea-b1391669d5d3",
  "order_id": "order123",
  "data": {
    "amount": 118708,
    "currency": "BRL",
    "customer_id": "test",
    "customer": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "john.doe@example.com",
      "document_type": "CPF",
      "document_number": "12345678900",
      "phone_number": "+5511999999999",
      "billing_address": {
        "street": "Av. Paulista",
        "number": "1000",
        "complement": "Apto 101",
        "district": "Bela Vista",
        "city": "São Paulo",
        "state": "SP",
        "country": "BR",
        "postal_code": "01310-100"
      }
    },
    "payment": {
      "payment_method": "CREDIT_PRE_AUTHORIZATION",
      "save_card_data": false,
      "transaction_type": "FULL",
      "number_installments": 1,
      "soft_descriptor": "LOJA*TESTE*COMPRA-123",
      "dynamic_mcc": 1799,
      "card": {
        "number": "5155901222260000",
        "expiration_month": "05",
        "expiration_year": "25",
        "cardholder_name": "CARD HOLDER",
        "security_code": "282"
      }
    },
    "additional_data": {
      "device": {
        "ip_address": "192.168.1.1",
        "device_id": "63c7f8ee-51a6-470d-bb76-ef762b62bfb7",
        "finger_print": "1a2b3c4d5e6f7g8h9i0j"
      }
    }
  }
}
```

### Response
#### Success Response (200)
- **idempotency_key** (string) - The idempotency key used in the request.
- **seller_id** (string) - The seller's unique identifier.
- **payment_id** (string) - The unique identifier for the payment.
- **order_id** (string) - The order identifier.
- **amount** (integer) - The transaction amount.
- **currency** (string) - The currency code.
- **status** (string) - The status of the payment (e.g., 'AUTHORIZED').
- **payment_method** (string) - The payment method used.
- **received_at** (string) - Timestamp when the payment was received.
- **transaction_id** (string) - The transaction identifier.
- **original_transaction_id** (string) - The original transaction identifier.
- **authorized_at** (string) - Timestamp when the payment was authorized.
- **reason_code** (string) - Code indicating the reason for the status.
- **reason_message** (string) - Message describing the reason code.
- **acquirer** (string) - The payment acquirer.
- **soft_descriptor** (string) - Soft descriptor for the transaction.
- **brand** (string) - The card brand.
- **authorization_code** (string) - The authorization code for the transaction.
- **acquirer_transaction_id** (string) - The acquirer's transaction identifier.

#### Response Example
```json
{
  "idempotency_key": "13c7f8ee-51a6-470d-bb76-ef762b62bfb7",
  "seller_id": "54f88e68-7764-4e87-8830-756b1e2c02f8",
  "payment_id": "d36887d0-53ec-4c36-b731-9bbeca18fcd2",
  "order_id": "123order2",
  "amount": 118708,
  "currency": "CLP",
  "status": "AUTHORIZED",
  "payment_method": "CREDIT_PRE_AUTHORIZATION",
  "received_at": "2025-08-12T20:46:26.713Z",
  "transaction_id": "MCC30105G5020",
  "original_transaction_id": "MCC30105G5020",
  "authorized_at": "2025-08-12T20:46:26.713Z",
  "reason_code": "00",
  "reason_message": "authorized",
  "acquirer": "GETNET",
  "soft_descriptor": "LOJA*TESTE*COMPRA-123",
  "brand": "MASTERCARD",
  "authorization_code": "604020",
  "acquirer_transaction_id": "204050301040206020503010"
}
```
```

--------------------------------

### Single-Step Payment Capture Request

Source: https://docs.globalgetnet.com/en/products/online-payments/regional-api?doc=create-single-step-payment&section=a9jrdctr742wx72m2g332q2r

Use this request to capture a payment in a single step. Ensure all mandatory fields, including customer and payment details, are provided. For specific markets like Uruguay, additional fields such as 'rates' and 'regional_regulation_code' are required.

```bash
curl -X POST https://api.globalgetnet.com/v1/payments \ 
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ 
-H "Content-Type: application/json" \ 
-d 
'{ 
 "idempotency_key": "a1b2c3d4-e5f6-7890-1234-567890abcdef", 
 "order_id": "ORD-20240101-001", 
 "request_id": "req_12345", 
 "data": { 
 "amount": 10000, 
 "currency": "BRL", 
 "customer": { 
 "first_name": "John", 
 "last_name": "Doe", 
 "email": "john.doe@example.com", 
 "phone_number": "+5511999999999", 
 "document_type": "CPF", 
 "document_number": "12345678900", 
 "billing_address": { 
 "street": "Rua Exemplo", 
 "number": "123", 
 "district": "Centro", 
 "city": "Sao Paulo", 
 "state": "SP", 
 "country": "BRA", 
 "postal_code": "01000000" 
 } 
 }, 
 "payment": { 
 "payment_method": "CREDIT", 
 "transaction_type": "FULL", 
 "number_installments": 1, 
 "card": { 
 "number": "4111111111111111", 
 "brand": "VISA", 
 "expiration_month": 12, 
 "expiration_year": 2025, 
 "security_code": "123", 
 "cardholder_name": "John Doe" 
 } 
 } 
 }, 
 "additional_data": { 
 "device": { 
 "ip_address": "192.168.0.1", 
 "device_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef", 
 "finger_print": "fingerprint_hash" 
 } 
 } 
 } 
}'
```

--------------------------------

### POST /dpm/payments-gwproxy/v2/payments

Source: https://docs.globalgetnet.com/en/products/online-payments/regional-api?doc=create-single-step-payment

Creates a new payment transaction using credit card details.

```APIDOC
## POST /dpm/payments-gwproxy/v2/payments

### Description
Processes a new payment transaction for an order.

### Method
POST

### Endpoint
https://api-sbx.globalgetnet.com/dpm/payments-gwproxy/v2/payments

### Parameters
#### Request Body
- **idempotency_key** (string) - Required - Unique key for idempotency
- **request_id** (string) - Required - Unique request identifier
- **order_id** (string) - Required - Merchant order identifier
- **data** (object) - Required - Payment and customer data object

### Request Example
{
  "idempotency_key": "63c7f8ee-51a6-470d-bb76-ef762b62bfb9",
  "request_id": "daac03dc-73db-453f-9bea-b1391669d5d3",
  "order_id": "ORDER-10187383",
  "data": {
    "amount": 118708,
    "currency": "BRL",
    "customer_id": "test",
    "customer": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "john.doe@example.com",
      "document_type": "CPF",
      "document_number": "12345678900",
      "phone_number": "+5511999999999",
      "billing_address": {
        "street": "Av. Paulista",
        "number": "1000",
        "complement": "Apto 101",
        "district": "Bela Vista",
        "city": "São Paulo",
        "state": "SP",
        "country": "BR",
        "postal_code": "01310-100"
      }
    },
    "payment": {
      "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": "Card Holder",
        "security_code": "517"
      }
    },
    "additional_data": {
      "device": {
        "ip_address": "192.168.1.1",
        "device_id": "63c7f8ee-51a6-470d-bb76-ef762b62bfb9",
        "finger_print": "1a2b3c4d5e6f7g8h9i0j"
      }
    }
  }
}

### Response
#### Success Response (200)
- **status** (string) - Transaction status (e.g., APPROVED)
- **payment_id** (string) - Unique payment identifier
- **transaction_id** (string) - Acquirer transaction identifier

#### Response Example
{
  "idempotency_key": "63c7f8ee-51a6-470d-bb76-ef762b62bfb9",
  "seller_id": "e0ed6f00-fdc5-46d6-9557-6a2cac641b09",
  "payment_id": "053de7f9-3725-437b-bdfc-bbf3ed0acb75",
  "order_id": "ORDER-10187383",
  "amount": 118708,
  "currency": "BRL",
  "status": "APPROVED",
  "payment_method": "CREDIT",
  "received_at": "2025-10-31T13:40:47.382Z",
  "transaction_id": "MCC50205G1020",
  "original_transaction_id": "MCC50205G1020",
  "authorized_at": "2025-10-31T13:40:47.382Z",
  "reason_code": "00",
  "reason_message": "captured",
  "acquirer": "GETNET",
  "soft_descriptor": "LOJA*TESTE*COMPRA-123",
  "brand": "MASTERCARD",
  "authorization_code": "204050",
  "acquirer_transaction_id": "405030304060404030501060"
}
```

--------------------------------

### Authenticate with OAuth 2.0 using cURL

Source: https://docs.globalgetnet.com/en/products/online-payments/regional-api/swagger

Use this request to obtain an access token by providing your Base64-encoded client credentials in the Authorization header.

```shell
curl https://api.pre.globalgetnet.com/authentication/oauth2/access_token \
  --request POST \
  --header 'Authorization: Basic c2J4XzlmMzQzZWMzLTczNjItNGY2Yi05N2UyLTIzY2FiMjA1M2I3NDo1YTE3MDAyMC05YzMzLTQ1NTUtODM0NC1mZjNiOTY0ZDY0Mzb=' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=client_credentials'
```

--------------------------------

### POST /dpm/payments-gwproxy/v2/payments

Source: https://docs.globalgetnet.com/en/products/online-payments/regional-api?doc=create-single-step-payment&section=a9jrdctr742wx72m2g332q2r

Initiates a payment transaction through the GlobalGetNet Regional API. This endpoint handles various payment methods and customer data.

```APIDOC
## POST /dpm/payments-gwproxy/v2/payments

### Description
Initiates a payment transaction. This endpoint allows for processing payments with various details including customer information, payment method, and transaction specifics.

### Method
POST

### Endpoint
https://api-sbx.globalgetnet.com/dpm/payments-gwproxy/v2/payments

### Headers
- `authorization`: Bearer <token>
- `content-type`: application/json
- `x-seller-id`: <seller_id>
- `x-transaction-channel-entry`: <channel_entry>

### Request Body
- **idempotency_key** (string) - Required - Unique key to ensure idempotency of the request.
- **request_id** (string) - Required - Unique identifier for the request.
- **order_id** (string) - Required - Identifier for the order.
- **data** (object) - Required - Contains the core payment and customer data.
  - **amount** (integer) - Required - The transaction amount in the smallest currency unit.
  - **currency** (string) - Required - The currency code (e.g., BRL).
  - **customer_id** (string) - Optional - Identifier for the customer.
  - **customer** (object) - Required - Customer details.
    - **first_name** (string) - Required - Customer's first name.
    - **last_name** (string) - Required - Customer's last name.
    - **email** (string) - Required - Customer's email address.
    - **document_type** (string) - Required - Type of customer document (e.g., CPF).
    - **document_number** (string) - Required - Customer's document number.
    - **phone_number** (string) - Required - Customer's phone number.
    - **billing_address** (object) - Required - Customer's billing address.
      - **street** (string) - Required - Street name.
      - **number** (string) - Required - Street number.
      - **complement** (string) - Optional - Apartment number or additional details.
      - **district** (string) - Required - Neighborhood.
      - **city** (string) - Required - City name.
      - **state** (string) - Required - State abbreviation.
      - **country** (string) - Required - Country code (e.g., BR).
      - **postal_code** (string) - Required - Postal code.
  - **payment** (object) - Required - Payment details.
    - **payment_method** (string) - Required - Method of payment (e.g., CREDIT).
    - **save_card_data** (boolean) - Optional - Whether to save card details.
    - **transaction_type** (string) - Required - Type of transaction (e.g., FULL).
    - **number_installments** (integer) - Optional - Number of installments.
    - **soft_descriptor** (string) - Optional - Soft descriptor for the transaction.
    - **dynamic_mcc** (integer) - Optional - Dynamic Merchant Category Code.
    - **card** (object) - Required if payment_method is CREDIT - Card details.
      - **number** (string) - Required - Card number.
      - **expiration_month** (string) - Required - Card expiration month (MM).
      - **expiration_year** (string) - Required - Card expiration year (YY).
      - **cardholder_name** (string) - Required - Name of the cardholder.
      - **security_code** (string) - Required - Card security code (CVV).
  - **additional_data** (object) - Optional - Additional data for the transaction.
    - **device** (object) - Optional - Device information.
      - **ip_address** (string) - Optional - IP address of the device.
      - **device_id** (string) - Optional - Device identifier.
      - **finger_print** (string) - Optional - Device fingerprint.

### Request Example
```json
{
  "idempotency_key": "63c7f8ee-51a6-470d-bb76-ef762b62bfb9",
  "request_id": "daac03dc-73db-453f-9bea-b1391669d5d3",
  "order_id": "ORDER-10187383",
  "data": {
    "amount": 118708,
    "currency": "BRL",
    "customer_id": "test",
    "customer": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "john.doe@example.com",
      "document_type": "CPF",
      "document_number": "12345678900",
      "phone_number": "+5511999999999",
      "billing_address": {
        "street": "Av. Paulista",
        "number": "1000",
        "complement": "Apto 101",
        "district": "Bela Vista",
        "city": "São Paulo",
        "state": "SP",
        "country": "BR",
        "postal_code": "01310-100"
      }
    },
    "payment": {
      "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": "Card Holder",
        "security_code": "517"
      }
    },
    "additional_data": {
      "device": {
        "ip_address": "192.168.1.1",
        "device_id": "63c7f8ee-51a6-470d-bb76-ef762b62bfb9",
        "finger_print": "1a2b3c4d5e6f7g8h9i0j"
      }
    }
  }
}
```

### Response
#### Success Response (200)
- **idempotency_key** (string) - Unique key for the transaction.
- **seller_id** (string) - Identifier for the seller.
- **payment_id** (string) - Unique identifier for the payment.
- **order_id** (string) - Identifier for the order.
- **amount** (integer) - The transaction amount.
- **currency** (string) - The currency code.
- **status** (string) - The status of the payment (e.g., APPROVED, DECLINED).
- **payment_method** (string) - The method used for payment.
- **received_at** (string) - Timestamp when the payment was received.
- **transaction_id** (string) - Unique identifier for the transaction from the acquirer.
- **original_transaction_id** (string) - Original transaction ID, if applicable.
- **authorized_at** (string) - Timestamp when the payment was authorized.
- **reason_code** (string) - Code indicating the reason for the status.
- **reason_message** (string) - Message describing the reason for the status.
- **acquirer** (string) - The payment acquirer (e.g., GETNET).
- **soft_descriptor** (string) - Soft descriptor used for the transaction.
- **brand** (string) - The card brand (e.g., MASTERCARD).
- **authorization_code** (string) - Authorization code for the transaction.
- **acquirer_transaction_id** (string) - Transaction ID from the acquirer.

#### Response Example
```json
{
  "idempotency_key": "63c7f8ee-51a6-470d-bb76-ef762b62bfb9",
  "seller_id": "e0ed6f00-fdc5-46d6-9557-6a2cac641b09",
  "payment_id": "053de7f9-3725-437b-bdfc-bbf3ed0acb75",
  "order_id": "ORDER-10187383",
  "amount": 118708,
  "currency": "BRL",
  "status": "APPROVED",
  "payment_method": "CREDIT",
  "received_at": "2025-10-31T13:40:47.382Z",
  "transaction_id": "MCC50205G1020",
  "original_transaction_id": "MCC50205G1020",
  "authorized_at": "2025-10-31T13:40:47.382Z",
  "reason_code": "00",
  "reason_message": "captured",
  "acquirer": "GETNET",
  "soft_descriptor": "LOJA*TESTE*COMPRA-123",
  "brand": "MASTERCARD",
  "authorization_code": "204050",
  "acquirer_transaction_id": "405030304060404030501060"
}
```
```
Tokens:
Raw