Skip to main content
POST
/
api
/
sandbox
/
transactions
/
:id
/
pay
Simular Pagamento
curl --request POST \
  --url https://api.example.com/api/sandbox/transactions/:id/pay
{
  "data.status": "<string>",
  "data.paidAt": "<string>"
}

​
Simular Pagamento

Simula a confirmação de pagamento de uma transação PIX criada no ambiente sandbox. Isso permite testar o fluxo completo de pagamento sem movimentar dinheiro real.
Este endpoint só funciona com transações criadas usando chaves de teste (sk_test_*).

​
Autenticação

Authorization: Bearer sk_test_xxx

​
Path Parameters

​
id
string
required
ID da transação sandbox (formato CUID).

​
Response (200)

{
  "success": true,
  "message": "Payment simulated successfully",
  "data": {
    "transactionId": "clx7a8b9c0d1e2f3g4h5",
    "status": "paid",
    "paidAt": "2026-01-16T10:05:00.000Z"
  }
}
​
data.status
string
Sempre paid em caso de sucesso.
​
data.paidAt
string
Data/hora em que o pagamento foi simulado (ISO 8601).

​
Efeitos

Ao simular o pagamento:
  1. O status da transação muda para paid
  2. O evento transaction_paid é disparado via webhook
  3. O email de confirmação de compra é enviado ao cliente

​
Erros

HTTPCódigoDescrição
401ERR_AUTH_009Token inválido
404ERR_TRANSACTION_001Transação não encontrada
400ERR_SANDBOX_002Transação não pertence ao sandbox
400ERR_TRANSACTION_002Transação não está com status waiting_payment

​
Exemplo

curl -X POST https://api.bobpayments.com/api/sandbox/transactions/clx7a8b9c0d1e2f3g4h5/pay \
  -H "Authorization: Bearer sk_test_xxx"

Precisa de ajuda?

Nossa equipe está disponível para auxiliar no processo de desenvolvimento. Entre em contato pelo e-mail [email protected].