Skip to main content
POST
/
api
/
v1
/
transactions
Criar nova transação
curl --request POST \
  --url https://api.payments.bob.company/api/v1/transactions/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer": {
    "name": "<string>",
    "document": "<string>",
    "documentType": "CPF",
    "email": "[email protected]",
    "phone": "<string>",
    "address": {
      "street": "<string>",
      "streetNumber": "<string>",
      "neighborhood": "<string>",
      "zipCode": "<string>",
      "city": "<string>",
      "state": "<string>",
      "complement": "<string>",
      "country": "BR"
    }
  },
  "payment": {
    "amountCents": 25000000,
    "product": "<string>",
    "quantity": 1,
    "expirationDays": 15
  },
  "originDomain": "<string>",
  "customerIp": "127.0.0.1"
}
'
{
  "success": true,
  "data": {
    "id": "<string>",
    "status": "<string>",
    "pixCode": "<string>",
    "expirationDate": "<string>"
  },
  "message": "<string>"
}

Authorizations

Authorization
string
header
required

Autenticação por API Key usando token SK (sk_live_xxx ou sk_test_xxx). Envie como: Authorization: Bearer sk_live_xxx

Body

application/json
customer
object
required
payment
object
required
originDomain
string
required

Domínio da loja/site que originou a transação (ex: loja.exemplo.com.br). Obrigatório para rastreio de múltiplas lojas. Use apenas o hostname, sem protocolo ou caminho.

Required string length: 1 - 253
customerIp

IP do usuário final que originou a requisição (IPv4 ou IPv6). Quando informado, é usado para detecção de fraude e bloqueio de IPs.

Pattern: ^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])$

Response

Default Response

success
boolean
default:true
required
data
object
required
message
string