Criar uma Transação Débito

POST

/v1/transactions

Última modificação:2026-03-31 17:24:26

13988aef-94d3-4635-a613-584b7575c2eb.jfif

Requisição

Parâmetros Bodyapplication/json

Exemplo

{
    "amount": 1500,
    "async": false,
    "capture": true,
    "installments": 1,
    "descriptor": "testpostman",
    "payment_method": "debit_card",
    "card": {
        "card_number": "5502091556851234",
        "card_holder_name": "Luke Skywalker",
        "card_expiration_date": "0333",
        "card_cvv": "111"
    },
    "threeDSecure": {
        "provider" : "ugo",
        "urlFail": "https://www.threeDSecure.com.br/?threeDSecure=fail",
        "urlSuccess": "https://www.threeDSecure.com.br/?threeDSecure=success",
        "onFailure": "decline",
        "userAgent": "Mozilla/5.0 (iPad; U; CPU OS 3_2_1 like Mac OS X; en-us) AppleWebKit/531.21.10 (KHTML, like Gecko) Mobile/7B405",
        "ipAddress": "192.168.130.20",
        "device": {
            "colorDepth": 1,
            "deviceType3ds": "BROWSER",
            "javaEnabled": false,
            "language": "BR",
            "screenHeight": 500,
            "screenWidth": 500,
            "timeZoneOffset": 3
        }
    },
    "billing": {
        "name": "Tatooine",
        "address": {
            "country": "br",
            "street": "Rua 12 de Outubro",
            "street_number": "220",
            "zipcode": "16520970",
            "state": "SP",
            "city": "Bacuriti",
            "neighborhood": "Centro"
        }
    },
    "customer": {
        "name": "Luke Skywalker",
        "email": "luke@skywalker.com",
        "type": "individual",
        "country": "BR",
        "external_id": "6564",
        "documents": [
            {
                "type": "CPF",
                "number": "01234567890"
            }
        ],
        "phone_numbers" : [
            "+5511916621234"
        ]
    },
    "items": [
        {
            "external_id": "5550134",
            "title": "Sabonete de Luxo",
            "unit_price": 10000,
            "quantity": 1,
            "tangible": true
        },
        {
            "external_id": "5550134",
            "title": "Sabonete de Luxo",
            "unit_price": 10000,
            "quantity": 1,
            "tangible": false
        }
    ]
}

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://prod.your-api-server.com/v1/transactions' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 1500,
    "async": false,
    "capture": true,
    "installments": 1,
    "descriptor": "testpostman",
    "payment_method": "debit_card",
    "card": {
        "card_number": "5502091556851234",
        "card_holder_name": "Luke Skywalker",
        "card_expiration_date": "0333",
        "card_cvv": "111"
    },
    "threeDSecure": {
        "provider" : "ugo",
        "urlFail": "https://www.threeDSecure.com.br/?threeDSecure=fail",
        "urlSuccess": "https://www.threeDSecure.com.br/?threeDSecure=success",
        "onFailure": "decline",
        "userAgent": "Mozilla/5.0 (iPad; U; CPU OS 3_2_1 like Mac OS X; en-us) AppleWebKit/531.21.10 (KHTML, like Gecko) Mobile/7B405",
        "ipAddress": "192.168.130.20",
        "device": {
            "colorDepth": 1,
            "deviceType3ds": "BROWSER",
            "javaEnabled": false,
            "language": "BR",
            "screenHeight": 500,
            "screenWidth": 500,
            "timeZoneOffset": 3
        }
    },
    "billing": {
        "name": "Tatooine",
        "address": {
            "country": "br",
            "street": "Rua 12 de Outubro",
            "street_number": "220",
            "zipcode": "16520970",
            "state": "SP",
            "city": "Bacuriti",
            "neighborhood": "Centro"
        }
    },
    "customer": {
        "name": "Luke Skywalker",
        "email": "luke@skywalker.com",
        "type": "individual",
        "country": "BR",
        "external_id": "6564",
        "documents": [
            {
                "type": "CPF",
                "number": "01234567890"
            }
        ],
        "phone_numbers" : [
            "+5511916621234"
        ]
    },
    "items": [
        {
            "external_id": "5550134",
            "title": "Sabonete de Luxo",
            "unit_price": 10000,
            "quantity": 1,
            "tangible": true
        },
        {
            "external_id": "5550134",
            "title": "Sabonete de Luxo",
            "unit_price": 10000,
            "quantity": 1,
            "tangible": false
        }
    ]
}'

Respostas

🟢200Criar uma Transação

application/json

Body

Exemplo

{
    "id": 1160552,
    "ip_address": "191.232.180.254",
    "installments": 1,
    "tid": null,
    "nsu": null,
    "authorization_code": null,
    "amount": 100,
    "capture_amount": 100,
    "paid_amount": null,
    "refund_amount": null,
    "payment_method": "debit_card",
    "ref_id": "H2RMXRL6T6",
    "status": "request_authentication",
    "created_at": "2024-05-17T21:18:47.000000Z",
    "updated_at": "2024-05-17T21:18:48.000000Z",
    "card": {
        "card_id": 1542470679,
        "card_holder_name": "Lucas Nalon",
        "created_at": "2024-05-17T21:18:46.000000Z",
        "updated_at": "2024-05-17T21:18:46.000000Z",
        "card_first_digits": "520048",
        "card_last_digits": "9887",
        "brand": "mastercard"
    },
    "pix_qr_code": null,
    "pix_expiration_date": null,
    "pix_additional_fields": null,
    "boleto": {
        "barcode_line": null,
        "code": null
    },
    "split_rules": [],
    "customer": {
        "id": 1383269,
        "external_id": "6564",
        "name": "Fulano Nogue",
        "email": "fulano2nogue@email.com",
        "type": "individual",
        "country": "BR",
        "phone_numbers": null,
        "documents": [
            {
                "id": 696424,
                "type": "cpf",
                "number": "30267903030"
            }
        ],
        "birthday": null,
        "created_at": "2024-05-17T21:18:46.000000Z",
        "updated_at": "2024-05-17T21:18:46.000000Z"
    },
    "billing": {
        "id": 311297,
        "name": "Brasil Cash",
        "created_at": "2024-05-17T21:18:47.000000Z",
        "updated_at": "2024-05-17T21:18:47.000000Z",
        "address": {
            "street": "Rua 12 de Outubro",
            "street_number": "220",
            "zipcode": "16520970",
            "country": "br",
            "state": "SP",
            "city": "Bacuriti",
            "neighborhood": "Centro",
            "complementary": null
        }
    },
    "shipping": null,
    "items": [
        {
            "id": 342584,
            "external_id": "5550134",
            "title": "Sabonete de Luxo",
            "unit_price": 10000,
            "quantity": 1,
            "tangible": 1,
            "category": null,
            "venue": null,
            "date": null,
            "created_at": "2024-05-17T21:18:47.000000Z",
            "updated_at": "2024-05-17T21:18:47.000000Z"
        },
        {
            "id": 342585,
            "external_id": "5550134",
            "title": "Sabonete de Luxo",
            "unit_price": 10000,
            "quantity": 1,
            "tangible": 0,
            "category": null,
            "venue": null,
            "date": null,
            "created_at": "2024-05-17T21:18:47.000000Z",
            "updated_at": "2024-05-17T21:18:47.000000Z"
        }
    ],
    "metadata": null,
    "refused_reason": null,
    "amount_fee": null,
    "descriptor": "descapi",
    "threeDSecure": {
        "url": "https://threeDSecure.com.br/processor/redirect/waBD%2b5zSsrXd26dUQc7DfU9mU8mrpA4q8VwvYFM3MENUCTMQw7Eg2GtdXizHMF2QKoJdC6cXXUUdCsGM2KCAqqMLrlEehGkCPCMOKx%2fTn9c0T7iKxpxi6208IuQl54XI2lYMpMU2HqvYCrfWq8QlmLhf0aKsbwN9x3qqNPRPhii0lpIco1YX%2fbqqsz9Z0%2bQexyQqT6R7JYpXliM%2b61oJhqDA%3d"
    }
}

🟠400Erro integração

Modificado em 2026-03-31 17:24:26

Página anterior

Criar uma Transação Boleto

Próxima página

Criar uma Transação - Split