📘 Criando uma autorização de pagamento com cartão de crédito

1º Passo - Tokenizar o cartão de crédito

Request:

POST https://{BASE_URL}/api/v2/cards/tokens

{
    "holder": {
        "name": "Tony Stark",
        "document": "51190844001"
    },
    "expiration": {
        "year": 2035,
        "month": 1
    },
    "cardNumber": "5448280000000007"
}

Response:

Para obter o token gerado utilize a URL da Location através do método GET, esse token deverá ser utilizado no próximo passo para solicitar uma autorização via cartão de crédito.

2º Passo - Solicitar a autorização

Request:

POST https://{BASE_URL}/api/v2/sellers/{sellerId}/orders/credit-card/authorize

{
    "orderReference": "TEST_{{$timestamp}}",
    "amount": 500,
    "customer": {
        "birthdate": "1992-02-29",
        "document": "55375716097",
        "name": "Teste Bempaggo",
        "address": {
            "street": "Rua Jair Hamms",
            "city": "Palhoca",
            "streetNumber": "38",
            "zipCode": "88137084",
            "neighborhood": "Pedra Branca",
            "state": "SC"
        }
    },
    "payments": [
        {
            "installments": 1,
            "cardToken": {
                "token": "643c663f3c244f939ef1f9acc6ccd75d3e2704f90ab64d5da9b6576d5ac3cc1d",
                "cvv": "123"
            },
            "amount": 500,
            "paymentMethod": "CREDIT_CARD",
            "paymentLimitDate": 1694314800000,
            "dueDate": {{$timestamp}}
        }
    ],
    "metadata": {
        "teste": "teste123",
        "erp_id": 9999
    }
}

Response Header:

No response header retornamos:

LOCATION: URL para obter a cobrança gerada, utilize para confirmar o status da autorização.

LINK (rel="capture"): URL para realizar a captura da cobrança.

LINK (rel="refund"): URL para realizar o estorno da cobrança.

LINK (rel="metadata"): URL para retornar a lista de metadados associados a cobrança.

3º Passo - Captura

Para efetuar a captura basta fazer um POST para o link (rel=captura) retornado na autorização (passo 2).