Creación de una Transacción
Este endpoint permite crear una transacción utilizando el identificador de reserva y el método de pago seleccionado previamente.
1. Método de Acceso
2. Datos de Envío
Para realizar la transacción, se deben proporcionar los siguientes parámetros:
3. Ejemplo de Petición
{
"ApiKey": "{partnerId}",
"ReservationId": "fdg34s334dsel",
"IsTest": false,
"AccessDateTime": "2025-02-05T00:00:00",
"PartnerSaleId": "0FAF19889ADDA",
"PaymentMethod": {
"PaymentMethodType": 1,
"ReturnUrlOk": "https://yourweb.com/success",
"ReturnUrlKo": "https://yourweb.com/failure"
},
"Client": {
"FullName": "Juan Pérez",
"Surname": "López",
"Email": "juan.perez@example.com"
},
"PointOfSale": {
"CustomCode": "Shop_001",
"Name": "My Shop",
"Description": "My shop description"
},
"Products": [
{
"ProductId": "ctgyir9m9q4bo",
"Tickets": [
{
"TicketId": "1tqgtrf7ctefc"
}
]
},
{
"ProductId": "htgy4tgm9q21n",
"Tickets": [
{
"TicketId": "jkp78j40cnfh3"
}
]
}
]
}
4. Estructura de la Respuesta
5. Ejemplo de Respuesta Exitosa
{
"Success": true,
"TransactionId": "5603191358506446612",
"SaleId": "5603191358506446612",
"PaymentStatus": 3,
"AccessDateTime": "2025-02-05T00:00:00",
"PaymentRedirectUrl": "{baseurl}/Payment/Tpv?encrypteddataforpayment",
"Products": [
{
"ProductId": "ctgyir9m9q4bo",
"AccessCode": "5058635698721396923",
"ProviderId": "by81fymhsmjgw",
"Status": 2,
"Tickets": [
{
"TicketId": "1tqgtrf7ctefc",
"AccessCode": "7338633218776390145",
"BillingCode": "xyz789/2025/qwerty"
}
]
}
],
"Documents": [
{
"SalesDocumentUrl": "{baseurl}/TransactionDownload/SalesDocument?SaleId=5603191358506446612"
}
]
}
6. Ejemplo de Respuesta con Error
{
"Success": false,
"ErrorMessage": "No se encontró la reserva especificada.",
"Timestamp": "2025-02-05T15:42:00.000Z"
}
7. Consideraciones Finales
- El ApiKey debe mantenerse en secreto y solo debe usarse en el servidor.
- El ReservationId es obligatorio y debe haberse obtenido previamente.
- El PaymentMethodType debe coincidir con un método de pago disponible.
- Si el Success es false, revisar ErrorMessage para entender la causa del error.
- La URL PaymentRedirectUrl es clave para completar pagos online.
El SaleId se usa posteriormente para generar facturas y controlar la venta.