Skip to main content
POST
https://api.gates2b.com
/
payments
Criar Pagamento
curl --request POST \
  --url https://api.gates2b.com/payments \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "clientMode": "<string>",
  "amount": 123,
  "expire_at": "<string>",
  "description": "<string>",
  "external_reference": "<string>",
  "redirect_url": "<string>",
  "phoneNumber": "<string>",
  "email": "<string>",
  "document_type": "<string>",
  "name_client": "<string>",
  "document_client": "<string>"
}
'
{
  "id": 12345,
  "amount": 150.5,
  "description": "Pagamento mensalidade",
  "clientMode": "fillDataNow",
  "redirect_url": "https://minhaapp.com/retorno",
  "email": "[email protected]",
  "phoneNumber": "+5511999999999",
  "document_type": "CPF",
  "expire_at": "2025-12-31T23:59:59Z",
  "document_client": "12345678900",
  "document_type_client": "CPF",
  "name_client": "João da Silva",
  "external_reference": "pedido-123",
  "id_transaction": "abc123xyz",
  "transaction_pix_id": "TRXPIX001",
  "emv": "00020101021226960014...",
  "name_receiver": "Empresa LTDA",
  "document_receiver": "11222333444455",
  "document_type_receiver": "CNPJ",
  "qr_image": "iVBORw0KGgoAAAANSUhEUgAAAQAAAAEAAQMAAABmvDol...",
  "qr_text": "00020101021226840014br.gov.bcb.pix2562...",
  "status": "Aguardando pagamento",
  "checkout_id": "ck_987654321",
  "createdAt": "2025-06-27T14:00:00-03:00",
  "updatedAt": "2025-06-27T14:00:00-03:00"
}
​
Authorization
string
required
O token de autenticação no formato Bearer é obrigatório para acessar este endpoint.
​
clientMode
string
required
Define o modo de tratamento dos dados do cliente. - noNeedToSpecify: Não exige dados do cliente. - fillDataNow: Dados do cliente devem ser fornecidos agora. - requestCheckout: Dados do cliente serão preenchidos via checkout.
​
amount
number
required
Valor do pagamento.
​
expire_at
string
required
Data e hora de expiração no formato ISO 8601.
​
description
string
Descrição do pagamento. Campo opcional.
​
external_reference
string
Referência externa à aplicação. Campo opcional.
​
redirect_url
string
URL de redirecionamento após pagamento. Campo opcional.
​
phoneNumber
string
Número de telefone do cliente. Campo opcional.
​
email
string
E-mail do cliente. Campo opcional.
​
document_type
string
Tipo de documento do cliente. Campo opcional.
​
name_client
string
Nome do cliente. Campo opcional.
​
document_client
string
Documento do cliente. Campo opcional.

​
Response

​
status
number
Código HTTP da resposta. Esperado: 201.
​
code
string
Código interno da operação.
​
response
object
{
  "id": 12345,
  "amount": 150.5,
  "description": "Pagamento mensalidade",
  "clientMode": "fillDataNow",
  "redirect_url": "https://minhaapp.com/retorno",
  "email": "[email protected]",
  "phoneNumber": "+5511999999999",
  "document_type": "CPF",
  "expire_at": "2025-12-31T23:59:59Z",
  "document_client": "12345678900",
  "document_type_client": "CPF",
  "name_client": "João da Silva",
  "external_reference": "pedido-123",
  "id_transaction": "abc123xyz",
  "transaction_pix_id": "TRXPIX001",
  "emv": "00020101021226960014...",
  "name_receiver": "Empresa LTDA",
  "document_receiver": "11222333444455",
  "document_type_receiver": "CNPJ",
  "qr_image": "iVBORw0KGgoAAAANSUhEUgAAAQAAAAEAAQMAAABmvDol...",
  "qr_text": "00020101021226840014br.gov.bcb.pix2562...",
  "status": "Aguardando pagamento",
  "checkout_id": "ck_987654321",
  "createdAt": "2025-06-27T14:00:00-03:00",
  "updatedAt": "2025-06-27T14:00:00-03:00"
}