Skip to main content
POST
/
payment-requests
Crear solicitud de pago
curl --request POST \
  --url https://api.pay.palomma.com/payment-requests \
  --header 'Content-Type: application/json' \
  --data '{
  "amount_cents": 500000,
  "description": "Pay subscription",
  "redirect_url": "https://palomma.com"
}'
{
  "id": "8f59ec29-3e8a-4cbd-b4c0-4f480b1fac15",
  "payment_url": "https://www.sandbox-pay.palomma.com/?transaccion=8f59ec29-3e8a-4cbd-b4c0-4f480b1fac15"
}
URLs base Producción: https://api.pay.palomma.com Sandbox: https://api.sandbox-pay.palomma.com

Body

application/json
​
amount_cents
integer
required

El monto de la transacción en centavos. Debe ser mayor a 500.000 (5.000), y menor al monto máximo negociado.

Example:

500000

​
description
string | null

Descripción opcional para la solicitud de pago. Puede ser una referencia de pago o algún texto breve que describa la transacción. El usuario verá esta descripción.

​
redirect_url
string | null

La URL a la que se redirecciona al usuario cuando haya terminado el pago a través de Palomma. Sobreescribe la URL de redirección configurado en el Onboarding.

​
ttl
integer | null

El tiempo en segundos que puede quedar la transacción en estado pendiente antes de ser cancelada. Si no se especifica y no está especificado para tu comercio en el Onboarding, la solicitud de pago no expira.

​
user_information
object

Información del usuario que está realizando el pago. Si no se incluye, se le pedirá al usuario que ingrese su información. Esta información se utiliza solamente para prellenar el registro de usuarios a Palomma. Como el usuario puede modificarla en el registro, o puede ya estar registrado en Palomma, no garantizamos que se utilice esta información para procesar el pago.

  • PersonInformation
  • BusinessInformation
​
enforced_document_number
string | null

Impone que la cuenta de banco vinculada a Palomma para realizar el pago esté asociada con la cédula especificada. Principalmente util por temas de cumplimento de normativas. Utilice este campo si necesita verificar que la cuenta de banco que se vincula a Palomma para realizar el pago la pertenece al usuario que está registrado en su servicio. Si la cuenta de banco no está asociada con la cédula especificada, el usuario no podrá completar su pago. Si no se especifica, no se verifica la cédula. Esta verificación aún no está activa con todos los bancos disponibles.

​
merchant_display_name
string | null

Especifica un nombre alternativo para el comercio que se le muestra al usuario.

​
merchant_support_info
string | null

Información de contacto alternativa que se le muestra al usuario en la confirmación de pago.

Response

​
id
string
required

Un identificador único para la solicitud de pago.

​
payment_url
string
required

El enlace de pago al que se debe redirigir al usuario para realizar el pago.

Example:

"https://www.sandbox-pay.palomma.com/?transaccion=8f59ec29-3e8a-4cbd-b4c0-4f480b1fac15"