CARTÃO

POST

/transactions

Valor mínimo R$5

Requisição

Parâmetros Header

Parâmetros Bodyapplication/json

Examples

Respostas

🟢201Created

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/transactions' \
--header 'x-api-key: sk_c6b0f1703772167d3ac262f4242a2d4e8ca8878bdec44ecb' \
--header 'Content-Type: application/json' \
--data-raw '{
  "amount": 5000,
  "method": "CREDIT_CARD",
  "installments": 1,
  "global": true, // enviar true caso seja transacao inernacional
  "customer": {
    "name": "Manuel Gomes",
    "email": "manuel@gmail.com",
    "phone": "+3292992323888333",
    "document": "1234567890",
    "documentType": "CPF"
  },
  "card": {
    "number": "4111111111111111",
    "holderName": "Manuel Gomes",
    "holderDocument": "1234567890",
    "expirationMonth": 8,
    "expirationYear": 29,
    "cvv": "123",
    "token": "xxx",
    "ip": "45.250.252.93",
    "currency": "BRL", // CASO FOR INTERNACIONAL, NAO É PERMITIDO O ENVIO DA CURRENCY COMO BRL
    "sessionId": "", // o sessionId deve ser inforrmado caso precise, nao é obrigatório
    // o 3DS deve ser inforrmado caso precise, nao é obrigatório
    "threeDS": {
      "cavv": "AAABBBCCC123456789",
      "xid": "XID123456789",
      "eci": "05",
      "version": "2.1.0",
      "referenceId": "REF987654321"
    }
  },
  "items": [
    {
      "title": "Chroma Absolu Volledig Verzorgingspakket – Kleurbehoud, Hydratatie en Glans",
      "quantity": 1,
      "amount": 6218,
      "tangible": true,
      "externalRef": "10077847912749"
    }
  ]
}'

Response Example

{
    "status": true,
    "data": {
        "id": "022d7383-2b95-4f75-be4b-fbba37ba50ae",
        "amount": 500,
        "customer": {
            "id": "82eb9fdf-06f5-4f9b-9a64-51714d0dfa00",
            "externalRef": null,
            "name": "John Doe",
            "email": "john@example.com",
            "phone": "1234567890",
            "documentType": "CPF",
            "document": "26841949048",
            "createdAt": "2025-06-27T12:03:50.890Z"
        },
        "items": [
            {
                "id": "7a10b701-43e9-47da-9cad-925543e52858",
                "title": "Wireless Mouse",
                "amount": 5999,
                "quantity": 1,
                "tangible": true,
                "externalRef": "item_abc123",
                "transactionId": "022d7383-2b95-4f75-be4b-fbba37ba50ae",
                "createdAt": "2025-06-27T12:03:50.890Z",
                "updatedAt": "2025-06-27T12:03:50.890Z"
            }
        ],
        "method": "CREDIT_CARD",
        "status": "FAILED", // PAID - PENDING
        "boleto": null,
        "card": {
            "id": "e42df45b-61cc-4e9d-939c-b52956cf01c6",
            "number": "",
            "holderName": "",
            "holderDocument": "",
            "expirationMonth": 0,
            "expirationYear": 0,
            "cvv": "",
            "brand": null,
            "createdAt": "2025-06-27T12:03:51.713Z",
            "updatedAt": "2025-06-27T12:03:51.713Z",
            "transactionId": "022d7383-2b95-4f75-be4b-fbba37ba50ae"
        },
        "pix": null,
        "description": null,
        "installments": null,
        "metadata": null,
        "paidAt": null,
        "postbackUrl": null,
        "createdAt": "2025-06-27T12:03:50.890Z"
    }
}

Modificado em 2025-11-17 12:41:27