- Pautas de integración
- Características soportadas (métodos de pago)
- Implementación de una integración de pago mediante explorador
- Pagos con Trustly
Trustly
Trustly es un pago por transferencia bancaria. Mediante Trustly, los pagadores pueden realizar pagos rápidos, sencillos y seguros directamente desde sus cuentas bancarias sin riesgo de robo de datos o fraude. Los pagadores también pueden realizar pagos de comercio electrónico y autenticar el pago a través de su interfaz bancaria en línea existente.
Se recomienda que lea las pautas de integración para los pagos mediante explorador, antes de crear una integración de Trustly.
Prerrequisitos
Para ofrecer Trustly como un método de pago mediante el <<paymentGateway>>:
- usted debe estar registrado con su proveedor de servicios de pago mediante explorador;
- su perfil de negocio en el <<paymentGateway>> se debe configurar usando los detalles de su cuenta con el proveedor de servicios de pago mediante explorador; y
- debe tener una cuenta bancaria en una de las monedas soportadas registrada en su cuenta de negocio en su proveedor de servicios de pago mediante explorador.
Transacciones de Trustly
Trustly admite transacciones que se originan en varios países con sus monedas correspondientes.
| País | Moneda |
|---|---|
| Austria (AUT) | EUR |
| Alemania (DEU) | EUR |
| Dinamarca (DNK) | EUR, DK |
| Estonia (EST) | EUR |
| España (ESP) | EUR |
| Finlandia (FIN) | EUR |
| Reino Unido (GBR) | GBP |
| Lituania (LTU) | EUR |
| Letonia (LVA) | EUR |
| Países Bajos (NLD) | EUR |
| Noruega (NOR) | EUR, NOK |
| Portugal (PRT) | EUR |
| Suecia (SWE) | EUR, SEK |
Integración de Trustly
La integración de <<checkout>> le permite recopilar detalles de pago del pagador a través de una interacción que se hospeda y se muestra en <<paymentGateway>>.
Desde la API versión 65 en adelante, Trustly está disponible automáticamente como método de pago una vez que <<paymentServiceProvider>> lo habilita y configura para este método de pago.
Para conocer más detalles, consulte Pagos mediante explorador a través de la integración de <<checkout>>.
La integración de <<directPayment>> le permite ofrecer el método de pago de Trustly en su propia página de pago.
Además de los campos estándar necesarios en una solicitud de pago mediante explorador, proporcione los siguientes campos en la solicitud Initiate Browser Payment:
Campos comunes
sourceOfFunds.type=TrustlybrowserPayment.operation=PAY (Trustly does not support the Authorize operation)customer.account.id=The ID, username, hash, or anything that is used to identify the consumercustomer.email=Email address of a payersourceOfFunds.provided.trustly.bankAccountHolder=Name of the bank account holder for the payer's bank accountsourceOfFunds.provided.trustly.bankAccountCountryCode=The country where payers have their bank account. Provide the ISO 3166 alpha-3 country code for this country.
Idioma preferido
Para configurar el idioma que prefiere que Trustly utilice para las páginas que se muestran al pagador, complete el campo browserPayment.preferredLanguage en la solicitud de Initiate Browser Payment. Sin embargo, el idioma se usará solo si Trustly lo admite.
{
"apiOperation": "INITIATE_BROWSER_PAYMENT",
"billing": {
"address": {
"country": "POL"
}
},
"browserPayment": {
"operation": "PAY",
"returnUrl": "<your_merchant_URL>"
},
"customer": {
"email": "john.smith@example.com",
"account": {
"id": "Customer"
}
},
"order": {
"amount": 100,
"currency": "PLN"
},
"sourceOfFunds": {
"type": "TRUSTLY",
"provided": {
"trustly": {
"bankAccountHolder": "Test Tester",
"bankAccountCountryCode": "POL"
}
}
}
}
Cómo interpretar el resultado de la transacción
La tabla especifica los códigos de respuesta de transacción para los posibles escenarios que puede encontrar después de iniciar un pago con Trustly.
| Respuesta de Initiate Browser Payment | Qué significa esto... |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
Redirigir al pagador utilizando la URL proporcionada en la respuesta. |
| Respuesta de Retrieve Transaction/Retrieve Order | Qué significa esto... |
response.gatewayCode=APPROVEDresult=SUCCESS |
El pago se realizó correctamente. |
response.gatewayCode=PENDINGresult=PENDING |
<<paymentGateway>> está esperando una notificación del adquirente sobre el resultado del pago. Pruebe RETRIEVE_TRANSACTION nuevamente más tarde o escuche las notificaciones de <<paymentGateway>>. |
response.gatewayCode=CANCELLEDresult=FAILURE |
El pagador canceló la interacción para este pago. Ofrezca al pagador la opción de probar otro método de pago. |
response.gatewayCode=DECLINED o ACQUIRER_SYSTEM_ERRORresult=FAILURE |
El pago fue rechazado. Ofrezca al pagador la opción de probar otro método de pago. En caso de un ACQUIRER_SYSTEM_ERROR, puede consultar con el adquirente el motivo del error del pago, o bien puede intentar RETRIEVE_TRANSACTION de nuevo. |
response.gatewayCode=TIMED_OUTresult=FAILURE |
Trate esto como un pago rechazado. El <<paymentGateway>> hará lo posible para asegurarse de que la transacción no se puede realizar o revertirá la transacción. |
Reembolsos
Puede reembolsar los pagos de Trustly en un número de pagos o el total. Asegúrese de estar configurado para reembolsos en el <<paymentGateway>> y en su cuenta de negocio en su proveedor de servicios de pagos mediante explorador.
Prueba de su integración
El <<paymentGateway>> proporciona un emulador de pagos mediante explorador que le permite probar su integración con Trustly.