Saltar al contenido principal
POST
https://api.gates2b.com
/
payments
Crear Pago
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": "cliente@exemplo.com",
  "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
requerido
El token de autenticacion en formato Bearer es obligatorio para acceder a este endpoint.
​
clientMode
string
requerido
Define el modo de tratamiento de los datos del cliente. - noNeedToSpecify: No requiere datos del cliente. - fillDataNow: Los datos del cliente deben enviarse ahora. - requestCheckout: Los datos del cliente se completaran via checkout.
​
amount
number
requerido
Valor del pago.
​
expire_at
string
requerido
Fecha y hora de expiracion en formato ISO 8601.
​
description
string
Descripcion del pago. Campo opcional.
​
external_reference
string
Referencia externa de la aplicacion. Campo opcional.
​
redirect_url
string
URL de redireccion despues del pago. Campo opcional.
​
phoneNumber
string
Numero de telefono del cliente. Campo opcional.
​
email
string
Correo del cliente. Campo opcional.
​
document_type
string
Tipo de documento del cliente. Campo opcional.
​
name_client
string
Nombre del cliente. Campo opcional.
​
document_client
string
Documento del cliente. Campo opcional.

​
Response

​
status
number
Codigo HTTP de la respuesta. Esperado: 201.
​
code
string
Codigo interno de la operacion.
​
response
object
{
  "id": 12345,
  "amount": 150.5,
  "description": "Pagamento mensalidade",
  "clientMode": "fillDataNow",
  "redirect_url": "https://minhaapp.com/retorno",
  "email": "cliente@exemplo.com",
  "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"
}