Saltar al contenido principal

Realizar pago de servicios

Esta operacion permite realizar un pago a traves de una tarjeta** Nueve09 ®.

Solicitud HTTP

POST /payment/bills

Parámetros del encabezado

EncabezadoDescripción
Authorization 
requerida
El bearer token creado en
 Obtener token de autorización
Content-Type 
requerido
application/json

Parámetros del cuerpo

ParámetroTipoPatrónDescripción
product_id
requerido
UUIDUUIDIdentificador unico del producto
card_number**
requerido
cadena16 dígitos*El card_number de la tarjeta**
phone_number
requerido
cadena10 dígitosNumero telefonico del beneficiario
email
requerido
cadenacorreo electronicoCorreo electronico del beneficiario
reference
requerido
cadena1-100 caracteresReferencia de pago del servicio
amount
requerido
flotantedígitosLa cantidad a pagar con la tarjeta
Nota

*Si el card_number se envía con 16 dígitos, se debe enviar cifrado y codificado en Base 64. Consulte Cifrado y codificación de datos

warning

**En el caso del card_number debe ser una tarjeta asociada al ecosistema de Nueve09 ®.

Ejemplo de solicitud JSON:

{
"product_id":"123e6734-e21r-42e4-a45j-556642446666",
"card_number": "t7wog3ytUChBC2xdLNe-sAQ-VXt7xgDi6U_iNSGQPyA7hPBYs1-_mLt",
"phone_number": "1122334455",
"email": "[email protected]",
"reference":"Se ha realizado un pago de xyzw",
"amount": 152.65343
}

Ejemplo de respuesta JSON:

{
"success": true,
"code": 0,
"message": "OK",
"data": {
"operation": {
"id": "123e6734-e21r-42e4-a45j-556642446666",
"authorization_code": "321",
"amount": 152.65343,
"payment_description": "pago de servicio",
"authorizer_date": "2024-01-01",
"authorizer_time": "12:00:00",
"creation_timestamp": "2024-01-01T12:00:00Z"
},
"bill_payment": {
"id": "123e6734-e21r-42e4-a45j-556642446666",
"phone_number": "1122334455",
"sku": "54321",
"reference": "Se ha realizado un pago de xyzw",
"message": "Se ha realizado el pago de super servicio premium",
"authorization_code": "123",
"amount": 152.65343,
"commission": 0.5,
"notification_email": "[email protected]",
"creation_timestamp": "2024-01-01T12:00:00Z",
"service": {
"name": "SUPER SERVICIO PREMIUM"
},
"product": {
"name": "SUPER PRODUCTO PREMIUM",
"description": ""
},
"status": {
"code": "484",
"description": ""
}
},
"card": {
"id": "12123214-2e34-4fff-844f-321654987123",
"masked_card_number": "************1234",
"last_four": "1234",
"type": "PHISYCAL",
"status": "ACTIVE"
},
"account": {
"id": "22222222-daa7-1234-aaaa-123123123ecd",
"reference": "555555555"
}
}
}