Liquide uma autorização anterior

POST

payment

{id}

capture

curl -X POST https://api.therius.io/v1/payment/9f8b2c1e-4d5a-6b7c-8d9e-0f1a2b3c4d5e/capture \
  -H "Authorization: Bearer prv_production_your_key_here" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantCode": "MERCHANT_001",
    "amount": { "currency": "USD", "value": 9900, "exponent": 2 }
  }'

{
  "id": "9f8b2c1e-4d5a-6b7c-8d9e-0f1a2b3c4d5e",
  "status": "captured",
  "paymentCode": "PC-1234567890",
  "orderCode": "ORDER-20240101-002",
  "merchantCode": "MERCHANT_001",
  "amount": { "currency": "USD", "value": 9900, "exponent": 2 }
}

Chame POST /payment/{id}/capture para liquidar fundos de um POST /payment/authorization anterior. Você pode capturar menos do que o valor total autorizado — uma captura parcial — e a retenção restante é liberada automaticamente. Você deve chamar este endpoint dentro da janela de autorização do adquirente (normalmente 7 dias) ou a retenção expira e você precisará autorizar novamente.

Identificar o pagamento

{id} é o id de pagamento do Therius devolvido na resposta a POST /payment/authorization (e POST /payment/purchase). Guarde-o quando você cria o pagamento. orderCode e paymentCode são os seus próprios campos de referência — não são aceitos como forma de endereçar o pagamento para captura, reembolso ou cancelamento. Um id que não existe, ou que pertence a outro lojista, devolve 404.

Exemplo

Captura total

curl -X POST https://api.therius.io/v1/payment/9f8b2c1e-4d5a-6b7c-8d9e-0f1a2b3c4d5e/capture \
  -H "Authorization: Bearer prv_production_your_key_here" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantCode": "MERCHANT_001",
    "amount": { "currency": "USD", "value": 9900, "exponent": 2 }
  }'

{
  "id": "9f8b2c1e-4d5a-6b7c-8d9e-0f1a2b3c4d5e",
  "status": "captured",
  "paymentCode": "PC-1234567890",
  "orderCode": "ORDER-20240101-002",
  "merchantCode": "MERCHANT_001",
  "amount": { "currency": "USD", "value": 9900, "exponent": 2 }
}

Captura parcial

curl -X POST https://api.therius.io/v1/payment/9f8b2c1e-4d5a-6b7c-8d9e-0f1a2b3c4d5e/capture \
  -H "Authorization: Bearer prv_production_your_key_here" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantCode": "MERCHANT_001",
    "amount": { "currency": "USD", "value": 7500, "exponent": 2 }
  }'

{
  "id": "9f8b2c1e-4d5a-6b7c-8d9e-0f1a2b3c4d5e",
  "status": "captured",
  "paymentCode": "PC-1234567890",
  "orderCode": "ORDER-20240101-002",
  "merchantCode": "MERCHANT_001",
  "amount": { "currency": "USD", "value": 7500, "exponent": 2 }
}

Quando você faz uma captura parcial, o Therius libera automaticamente a retenção restante ($24.00 no exemplo acima). Você não precisa enviar uma requisição de cancelamento separada para a parte não capturada.

Você só pode capturar um pagamento autorizado uma vez. Se você precisar capturar um valor diferente depois que uma captura parcial já foi processada, você precisará criar uma nova autorização.

Passe sempre um Idempotency-Key na captura. Se o seu servidor esgotar o tempo limite e você tentar de novo, a mesma chave garante que você não liquidará duas vezes a mesma autorização.

Autorizações

Authorization

string

header

obrigatório

Your secret API key: Bearer prv_production_xxx (production) or Bearer prv_sandbox_xxx (sandbox).

Cabeçalhos

Idempotency-Key

string<uuid>

A UUID you generate per operation. Required in production. Retrying with the same key returns the original response.

Parâmetros de caminho

string<uuid>

obrigatório

The Therius payment id returned by POST /payment/authorization or POST /payment/purchase.

Corpo

application/json

merchantCode

string

obrigatório

Your merchant account identifier. Validated against the Bearer key's merchant; required if the key maps to more than one merchant account.

amount

object

obrigatório

Show child attributes

reference

string

Optional internal reference for this capture operation.

commercialData

object

Level 2/3 card data for this capture. Send it when the data was not sent with the authorization or when the captured amount or lines differ from it. Validated against this capture amount.

Show child attributes

lineItems

object[]

Line items for the Level 3 breakdown of this capture. Used only when commercialData is also sent.

Show child attributes

Resposta

200 - application/json

Capture result

Result of a capture, refund, cancel or cancel_or_refund.

string

The Therius payment id.

merchantCode

string

orderCode

string

paymentCode

string

Therius receipt ID.

amount

object

Show child attributes

status

enum<string>

Outcome of the operation.

Opções disponíveis:

captured,

refunded,

canceled,

failed

curl -X POST https://api.therius.io/v1/payment/9f8b2c1e-4d5a-6b7c-8d9e-0f1a2b3c4d5e/capture \
  -H "Authorization: Bearer prv_production_your_key_here" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantCode": "MERCHANT_001",
    "amount": { "currency": "USD", "value": 9900, "exponent": 2 }
  }'

{
  "id": "9f8b2c1e-4d5a-6b7c-8d9e-0f1a2b3c4d5e",
  "status": "captured",
  "paymentCode": "PC-1234567890",
  "orderCode": "ORDER-20240101-002",
  "merchantCode": "MERCHANT_001",
  "amount": { "currency": "USD", "value": 9900, "exponent": 2 }
}

Pagamentos

Links de pagamento

Tokenização

Assinaturas

Subscription Plans

Sessão do SDK

Liquide uma autorização anterior

Identificar o pagamento

Exemplo

Captura total

Captura parcial

Autorizações

Cabeçalhos

Parâmetros de caminho

Corpo

Resposta

​Identificar o pagamento

​Exemplo

​Captura total

​Captura parcial

Autorizações

Cabeçalhos

Parâmetros de caminho

Corpo

Resposta

Identificar o pagamento

Exemplo

Captura total

Captura parcial