Transferencias P2P

Transacción P2P

La funcionalidad P2P le ayuda a proporcionar a los usuarios (clientes actuales o potenciales) la posibilidad de enviarse dinero entre ellos. También permite recibir transferencias en sus tarjetas, sin enviar sus datos a nadie, y ganar comisiones proporcionando el servicio a un amplio círculo de usuarios.

El servicio P2P es un servicio disponible para configuración e integración con sitios web de terceros, aplicaciones móviles, así como bancos de internet y móviles.

Los usuarios tienen acceso a una lista completa de operaciones, envío/recepción de transferencias, registro/autorización en el servicio, gestión de tarjetas guardadas.

Una característica importante del servicio P2P es la posibilidad de realizar transferencias por número de teléfono, incluso si el usuario aún no está registrado en el sistema.

Existen varios escenarios para la implementación de transacciones P2P:

• Los datos del portador de la tarjeta se ingresan del lado de la pasarela
• Los datos del portador de la tarjeta se ingresan del lado de la tienda online

Escenario de procesamiento de operación P2P con ingreso de datos de pago del lado de la pasarela de pago

1. En el sitio del vendedor (por ejemplo, en una tienda online) el portador de la tarjeta solicita la ejecución de una transferencia de dinero P2P.
2. El sistema de la tienda online registra el pedido en la Pasarela de pago a través de registerP2P.do. Los parámetros de registro utilizados incluyen el monto de la transferencia, moneda, número del pedido en el sistema del vendedor y URL de retorno para el cliente.
   
3. La pasarela de pago en respuesta a la solicitud de registro devuelve un identificador único del pedido en el sistema de pago y URL para redirigir al cliente al formulario de recolección de datos de tarjeta.
4. El sistema de la tienda online transfiere la dirección URL de redirección, recibida en el Paso 3, al navegador del cliente.
5. El navegador del cliente abre la dirección URL.
6. Por la URL especificada el navegador del cliente obtiene el formulario para la recolección de datos de tarjeta.
7. El cliente completa el formulario, y los datos se envían al servidor de la pasarela de pago.
8. El sistema verifica la pertenencia de la tarjeta a 3-D Secure (SecureCode).
9. La pasarela envía el enlace de redirección a la página del servidor de control de acceso (ACS) del banco emisor en el navegador web del cliente (este paso es necesario para la implementación de 3DS).
10. El navegador web del cliente solicita el formulario de autorización de usuario de ACS.
11. ACS envía el formulario de autorización al navegador web del cliente.
12. El cliente completa el formulario, y los datos se envían al servidor de la pasarela de pago.
13. ACS procesa el formulario y, independientemente del resultado, envía la dirección URL de redirección de las páginas de la pasarela de pago al navegador web del cliente. Junto con esta URL se envían los parámetros encriptados del resultado de autorización.
14. El navegador web del cliente solicita la página de la pasarela de pagos al transmitir parámetros cifrados del resultado de autorización.
15. La pasarela de pagos transfiere el dinero.
16. Cuando el dinero es transferido, la pasarela de pagos envía la URL de retorno al navegador web del cliente (la URL fue especificada durante el registro del pedido por la tienda en línea en el Paso 2).
17. El navegador web del cliente solicita los resultados de la transferencia de dinero de la tienda en línea.
18. El sistema de la tienda en línea solicita información sobre el estado del pedido de la pasarela de pagos – getP2PStatus.do.
    
19. La pasarela de pagos devuelve el estado del pedido.
20. El sistema de la tienda en línea muestra al cliente el resultado del pago.

Escenario de realización de operación P2P con entrada de datos de pago del lado de la tienda en línea

1. El portador de la tarjeta (cliente) interactúa con la tienda en línea para crear un pedido.
2. El sistema de la tienda en línea recopila los datos de la tarjeta en su lado.
3. El sistema de la tienda en línea registra el pedido en la Pasarela de pagos a través de registerP2P.do. Los parámetros de registro utilizados incluyen la suma de transferencia, moneda, número de pedido en el sistema del vendedor y URL de retorno para el cliente.
   
4. La pasarela de pagos en respuesta a la solicitud de registro devuelve el identificador único del pedido en el sistema de pagos.
5. Opcional. Si la tienda en línea trabaja con comisión, la tienda en línea envía a la pasarela de pagos una solicitud de suma de comisión a través de verifyP2P.do / verifyP2PByBinding.do.
   
6. Opcional. La pasarela de pagos envía en respuesta la suma de comisión.
7. La tienda en línea envía una solicitud de transferencia de fondos a la Pasarela de pago a través de performP2P.do / performP2PByBinding.do.
   En esta etapa se inicia el funcionamiento de 3DS2.
   
8. La Pasarela de pago verifica en el servidor 3DS si el cliente puede autenticarse utilizando el protocolo 2.0.
9. La Pasarela de pago envía respuesta a la solicitud realizada en el Paso 6. La respuesta también devuelve los siguientes parámetros:
   
   • is3DSVer2 - bandera de posibilidad de autenticación 3DSv2 (true/false)
   • threeDSServerTransId - identificador de transacción asignado por el servidor 3DS
   • threeDSMethodURLServer - dirección del servidor 3DS para recolección de datos del navegador
   • threeDSMethodURL - (opcional) dirección del servidor ACS para recolección de datos del navegador
   • threeDSMethodDataPacked - (opcional) datos para recolección de datos del navegador en ACS
   
   (Ver también descripción de la solicitud).
10. La tienda en línea invoca threeDSMethodURLServer en un iframe separado utilizando el método POST, usando el valor obtenido de la respuesta a la solicitud de transferencia de fondos. Esto permite al servidor 3DS recopilar datos sobre el navegador del cliente.
11. Opcional. Si en la respuesta a la solicitud de transferencia de fondos se obtuvieron los parámetros threeDSMethodURL y threeDSMethodDataPacked, la tienda en línea invoca en un iframe separado mediante método POST threeDSMethodURL.
    
12. Transferencia de fondos - etapa 2. La tienda en línea vuelve a enviar solicitud para ejecutar la transferencia a través de performP2P.do / performP2PByBinding.do.
    Es necesario pasar el parámetro threeDSServerTransId - identificador de transacción que fue creado por el servidor 3DS y devuelto en el Paso 10.
    
13. La Pasarela de pago envía solicitud de autenticación al servidor 3DS.
14. El servidor 3DS envía solicitud de autenticación (AReq) al servidor ACS.
15. El servidor ACS envía respuesta a la solicitud de autenticación (ARes) al servidor 3DS.
16. El servidor 3DS envía los datos recibidos a la pasarela de pago.
17. 
    
    • Si el cliente no necesita pasar autenticación en ACS, la pasarela de pago devuelve respuesta a la solicitud de transferencia de fondos. En este caso el escenario continúa desde el Paso 27.
    • Si el cliente necesita pasar autenticación en ACS, la Pasarela de pago enviará respuesta a la página de pago con datos de redirección a ACS.
18. La página de pago se redirige a acsUrl con el parámetro creq=packedCReq.
19. ACS muestra la página de autenticación para el cliente (página challenge).
20. El cliente está autenticado.
21. El servidor ACS verifica la autenticidad de los datos de autenticación.
22. Ocurre intercambio de datos entre los servidores ACS y 3DS y se confirma el resultado del procesamiento.
23. El servidor ACS redirige al cliente a la página de la tienda.
24. La tienda en línea envía solicitud /p2p/finishThreeDsVer2.do a la pasarela de pago.
25. La Pasarela de pago envía a la tienda en línea respuesta a la solicitud realizada.
26. La tienda en línea envía getP2PStatus.do a la pasarela de pagos para conocer el estado del pedido.
27. La pasarela de pagos envía respuesta a la solicitud realizada.
28. La tienda en línea muestra la página de resultado al cliente.

Transacción AFT

AFT (Account Funding Transaction) – tipo especial de operaciones de débito de fondos con el objetivo de recargar la cuenta interna del cliente en el sistema del comerciante o cuenta bancaria en el sistema del banco (frecuentemente utilizada como alternativa a la operación de compra).

El escenario de operación AFT tiene las siguientes características:

• Al ejecutar una transacción AFT en la solicitud de registro de pedido es necesario transmitir el parámetro features con el valor WITHOUT_TO_CARD.
• En la transacción AFT en la solicitud de pago o en la solicitud de pago por enlace se indican únicamente los datos de la tarjeta de débito, es decir, fromCard.

Escenario de operación AFT con introducción de datos de pago en el lado de la pasarela de pago

1. En el sitio web del vendedor (por ejemplo, en una tienda en línea) el portador de la tarjeta solicita la ejecución de una transferencia monetaria P2P.
2. El sistema de la tienda online registra el pedido en la Pasarela de Pagos a través de registerP2P.do con el parámetro features=WITHOUT_TO_CARD. Los parámetros de registro utilizados incluyen el monto de la transferencia, la moneda, el número de pedido en el sistema del vendedor y la URL de retorno para el cliente.
   
3. La Pasarela de Pagos en respuesta a la solicitud de registro devuelve un identificador único del pedido en el sistema de pagos y la URL para redirigir al cliente al formulario de recopilación de datos de tarjeta.
4. El sistema de la tienda online transmite la dirección URL de redirección obtenida en el Paso 3 al navegador del cliente.
5. El navegador del cliente abre la dirección URL.
6. En la URL indicada, el navegador del cliente obtiene el formulario para recopilar datos de tarjeta.
7. El cliente llena el formulario y los datos se envían al servidor de la pasarela de pagos.
8. El sistema verifica la pertenencia de la tarjeta a 3-D Secure (SecureCode).
9. La pasarela envía el enlace de redirección a la página del servidor de control de acceso (ACS) del banco emisor al navegador web del cliente (este paso es necesario para implementar 3DS).
10. El navegador web del cliente solicita el formulario de autorización de usuario de ACS.
11. ACS envía el formulario de autorización al navegador web del cliente.
12. El cliente llena el formulario y los datos se envían al servidor de la pasarela de pagos.
13. ACS procesa el formulario y, independientemente del resultado, envía la dirección URL de redirección de páginas de la pasarela de pagos al navegador web del cliente. Junto con esta URL se envían parámetros cifrados del resultado de autorización.
14. El navegador web del cliente solicita la página de la pasarela de pagos al transmitir parámetros cifrados del resultado de autorización.
15. La Pasarela de Pagos transfiere el dinero.
16. Cuando el dinero es transferido, la pasarela de pagos envía la dirección URL de retorno al navegador web del cliente (la dirección URL fue especificada durante el registro del pedido por la tienda online en el Paso 2).
17. El navegador web del cliente solicita los resultados de la transferencia de dinero de la tienda online.
18. El sistema de la tienda online solicita información sobre el estado del pedido a la pasarela de pagos – getP2PStatus.do.
    
19. La Pasarela de Pagos devuelve el estado del pedido.
20. El sistema de la tienda online muestra al cliente el resultado del pago.

Escenario de operación AFT con ingreso de datos de pago del lado de la tienda online

Este escenario puede ejecutarse de dos maneras:

• Registro y pago en una solicitud (instantPerformP2P.do)
• Registro y pago en solicitudes separadas (registerP2P.do+performP2P.do/performP2PByBinding.do)

Registro y pago en una solicitud

1. El titular de la tarjeta (cliente) interactúa con la tienda online para crear un pedido.
2. La tienda online recopila los datos de la tarjeta en su lado.
3. La tienda online registra el pedido e inicia el pago, enviando una solicitud instantPerformP2P.do.
4. La pasarela de pago consulta al servidor 3DS si el cliente puede pasar la autenticación 3DS2.
5. La pasarela de pago envía respuesta a la solicitud. La respuesta también devuelve los siguientes parámetros:
   
   • threeDSServerTransId - identificador de transacción asignado por el servidor 3DS
   • threeDSMethodURLServer - dirección del servidor 3DS para la recopilación de datos del navegador
   • threeDSMethodURL - (opcional) dirección del servidor ACS para la recopilación de datos del navegador
   • threeDSMethodDataPacked - (opcional) datos para la recopilación de datos del navegador en ACS
   
   (Ver también descripción de la solicitud).
6. La tienda online llama a threeDSMethodURLServer en un iframe separado usando el método POST, utilizando el valor obtenido de la respuesta a la solicitud de transferencia de fondos. Esto permite al servidor 3DS recopilar datos sobre el navegador del cliente.
7. Opcional. Si en la respuesta a la solicitud de transferencia de fondos se obtuvieron los parámetros threeDSMethodURL y threeDSMethodDataPacked, la tienda online llama en un iframe separado mediante el método POST a threeDSMethodURL.
   
8. La tienda online vuelve a enviar la solicitud instantPerformP2P.do, para ejecutar la transferencia.
   
   Es necesario pasar el parámetro threeDSServerTransId - identificador de transacción que fue creado por el servidor 3DS y devuelto en el Paso 5.
   
9. La pasarela de pago envía solicitud de autenticación al servidor 3DS.
10. El servidor 3DS intercambia datos con ACS.
11. El servidor 3DS envía los datos obtenidos a la pasarela de pago.
12. 
    
    • Si el cliente no necesita pasar autenticación en ACS, la pasarela de pago devuelve respuesta a la solicitud de transferencia de fondos. En este caso el escenario continúa desde el Paso 27.
    • Si el cliente necesita pasar autenticación en ACS, la pasarela de pago enviará respuesta a la página de pago con datos de redirección a ACS.
13. La página de pago se redirige a acsUrl con el parámetro creq=packedCReq.
14. ACS muestra la página de autenticación para el cliente (página challenge).
15. El cliente está autenticado.
16. El servidor ACS verifica la autenticidad de los datos de autenticación.
17. Ocurre intercambio de datos entre servidores ACS y 3DS y se confirma el resultado del procesamiento.
18. El servidor ACS redirige al cliente a la página de la tienda.
19. La tienda online envía solicitud /p2p/finishThreeDsVer2.do a la pasarela de pago.
20. La pasarela de pago envía a la tienda online respuesta a la solicitud realizada.
21. La tienda online envía getP2PStatus.do a la pasarela de pago para conocer el estado del pedido.
22. La pasarela de pago envía respuesta a la solicitud realizada.
23. La tienda online muestra la página de resultado al cliente.

Registro y pago en solicitudes separadas

1. El titular de la tarjeta (cliente) interactúa con la tienda en línea para crear un pedido.
2. El sistema de la tienda en línea recopila los datos de la tarjeta en su lado.
3. El sistema de la tienda en línea registra el pedido en la Pasarela de pagos a través de registerP2P.do con el parámetro features=WITHOUT_TO_CARD. Los parámetros de registro utilizados incluyen el monto de transferencia, moneda, número de pedido en el sistema del vendedor y URL de retorno para el cliente.
   
4. La Pasarela de pagos en respuesta a la solicitud de registro devuelve un identificador único del pedido en el sistema de pagos.
5. Opcional. Si la tienda en línea trabaja con comisión, la tienda en línea envía a la pasarela de pagos una solicitud del monto de comisión a través de verifyP2P.do / verifyP2PByBinding.do.
   
6. Opcional. La Pasarela de pagos envía en respuesta el monto de comisión.
7. La tienda en línea envía una solicitud de transferencia de fondos a la Pasarela de pagos a través de performP2P.do / performP2PByBinding.do, especificando los datos de la tarjeta de débito en el bloque fromCard.
   En esta etapa se inicia el trabajo de 3DS 2.0.
   
8. La Pasarela de pagos verifica en el servidor 3DS si el cliente puede autenticarse utilizando el protocolo 2.0.
9. La pasarela de pagos envía una respuesta a la solicitud realizada en el Paso 6. La respuesta también devuelve los siguientes parámetros:
   
   • is3DSVer2 - indicador de posibilidad de autenticación 3DSv2 (true/false)
   • threeDSServerTransId - identificador de transacción asignado por el servidor 3DS
   • threeDSMethodURLServer - dirección del servidor 3DS para la recopilación de datos del navegador
   • threeDSMethodURL - (opcional) dirección del servidor ACS para la recopilación de datos del navegador
   • threeDSMethodDataPacked - (opcional) datos para la recopilación de datos del navegador en ACS
   
   (Ver también descripción de la solicitud).
10. La tienda online invoca threeDSMethodURLServer en un iframe separado utilizando el método POST, usando el valor obtenido de la respuesta a la solicitud de transferencia de fondos. Esto permite al servidor 3DS recopilar datos sobre el navegador del cliente.
11. Opcional. Si en la respuesta a la solicitud de transferencia de fondos se obtuvieron los parámetros threeDSMethodURL y threeDSMethodDataPacked, la tienda online invoca en un iframe separado mediante método POST threeDSMethodURL.
    
12. Transferencia de fondos - etapa 2. La tienda online envía nuevamente una solicitud para ejecutar la transferencia a través de performP2P.do / performP2PByBinding.do.
    Es necesario pasar el parámetro threeDSServerTransId - identificador de transacción que fue creado por el servidor 3DS y devuelto en el Paso 10.
    
13. La pasarela de pagos envía una solicitud de autenticación al servidor 3DS.
14. El servidor 3DS envía una solicitud de autenticación (AReq) al servidor ACS.
15. El servidor ACS envía una respuesta a la solicitud de autenticación (ARes) al servidor 3DS.
16. El servidor 3DS envía los datos recibidos a la pasarela de pagos.
17. 
    
    • Si el cliente no necesita pasar por autenticación en ACS, la pasarela de pagos devuelve una respuesta a la solicitud de transferencia de fondos. En este caso el escenario continúa desde el Paso 27.
    • Si el cliente necesita pasar por autenticación en ACS, la pasarela de pagos enviará una respuesta a la página de pagos con datos de redirección a ACS.
18. La página de pago se redirige a acsUrl con el parámetro creq=packedCReq.
19. ACS muestra la página de autenticación para el cliente (página challenge).
20. El cliente está autenticado.
21. El servidor ACS verifica la autenticidad de los datos de autenticación.
22. Se produce un intercambio de datos entre los servidores ACS y 3DS y se confirma el resultado del procesamiento.
23. El servidor ACS redirige al cliente a la página de la tienda.
24. La tienda online envía una solicitud /p2p/finishThreeDsVer2.do a la pasarela de pagos.
25. La pasarela de pagos envía a la tienda online una respuesta a la solicitud realizada.
26. La tienda online envía getP2PStatus.do a la pasarela de pagos para conocer el estado del pedido.
27. La pasarela de pagos envía una respuesta a la solicitud realizada.
28. La tienda online muestra la página de resultado al cliente.

Transacción OCT

OCT (Original Credit Transaction) - tipo especial de transacciones para acreditar fondos monetarios al destinatario en tiempo real.

• En la transacción OCT en la solicitud de pago se indican solo los datos de la tarjeta de acreditación, es decir, toCard.
• Al ejecutar la transacción OCT en la solicitud de registro de pedido es necesario transmitir el parámetro features con el valor WITHOUT_FROM_CARD.

Escenario de realización de transacción OCT

1. El titular de la tarjeta (cliente) interactúa con la tienda en línea para crear el pedido.
2. El sistema de la tienda en línea registra el pedido en la Pasarela de pago a través de registerP2P.do. Los parámetros de registro utilizados incluyen el monto de transferencia, moneda, número de pedido en el sistema del vendedor y URL de retorno para el cliente.
3. La Pasarela de pago en respuesta a la solicitud de registro devuelve un identificador único del pedido en el sistema de pago y URL para redirigir al cliente al formulario de recopilación de datos de tarjeta.
4. El sistema de la tienda en línea transmite la dirección URL de redirección obtenida en el Paso 3 al navegador del cliente.
5. El cliente completa el formulario, y los datos se envían al servidor de la pasarela de pago.
6. La Pasarela de pago realiza la transferencia de fondos a través de performP2P.do.
7. Cuando el dinero es transferido, la pasarela de pago envía la URL de retorno al navegador web del cliente (la URL fue especificada durante el registro del pedido por la tienda en línea en el Paso 2).
8. El navegador web del cliente solicita los resultados de la transferencia de dinero de la tienda en línea.
9. El sistema de la tienda en línea solicita información sobre el estado del pedido a la pasarela de pago – getP2PStatus.do.
10. La Pasarela de pago devuelve el estado del pedido.
11. El sistema de la tienda en línea muestra al cliente el resultado del pago.

Llamadas API

Las solicitudes de transacciones P2P deben estar firmadas. La información sobre firmas de solicitudes está disponible en nuestra Guía de API.

Registro de pedido P2P

Para procesar un pedido de transferencia de dinero de tarjeta a tarjeta utilice la solicitud https://dev.bpcbt.com/payment/rest/api/p2p/registerP2P.do.

Al ejecutar la solicitud es necesario usar el encabezado: Content-Type: application/json

Parámetros de solicitud

Descripción de los parámetros del objeto shippingPayerData:

Descripción de los parámetros del objeto preOrderPayerData:

Descripción de los parámetros del objeto orderPayerData.

A continuación se muestran los parámetros del bloque billingPayerData (datos sobre la dirección de registro del cliente).

A continuación se presentan los parámetros del bloque billingRecipientData (datos sobre el destinatario).

Parámetros de respuesta

Ejemplos

Ejemplo de solicitud

curl -X POST 'https://dev.bpcbt.com/payment/rest/api/p2p/registerP2P.do'
-H 'Content-Type: application/json'
--data-raw '{
  "username":"test_user",
  "password":"test_user_password",
  "amount" : 50000,
  "currency" : "978",
  "returnUrl" : "https://mybestmerchantreturnurl.com",
  "orderNumber": "1"
}'

Ejemplo de solicitud de operación OCT

curl -X POST 'https://dev.bpcbt.com/payment/rest/api/p2p/registerP2P.do'
-H 'Content-Type: application/json'
--data-raw '{
  "username":"test_user",
  "password":"test_user_password",
  "amount" : 50000,
  "currency" : "978",
  "returnUrl" : "https://mybestmerchantreturnurl.com",
  "orderNumber": "12",
  "clientId": "122313",
  "creditBindingId": "99ef0cee-34fe-7312-ad7c-78bc00b3236a",
  "transactionTypeIndicator": "A",
  "features":{
      "feature":["FEATURE_1", "FEATURE_2", .. "FEATURE_N"]
   }
}'

Ejemplo de solicitud con especificación de datos del remitente y destinatario

curl -X POST 'https://dev.bpcbt.com/payment/rest/api/p2p/registerP2P.do' \
--header 'Content-Type: application/json' \
--data-raw '{ 
  "username": "test_user",
  "password": "test_user_password",
  "amount" : 1500,
  "currency" : "978",
  "returnUrl" : "https://mybestmerchantreturnurl.com",
  "failUrl" : "https://failUrl.com",
  "orderNumber": "01rthtbkuysgr",
  "email" : "test@test.com",

    "billingPayerData": {
        "payerAccount": "DE89370400440532013000",
        "payerLastName": "CHINA",
        "payerFirstName": "Mieville",
        "payerMiddleName": "Tom",
        "payerCombinedName": "CHINA Mieville",
        "payerIdType": "IDTP1",
        "payerIdNumber": "792209292",
        "billingCity": "BUD",
        "billingCountry": "348",
        "billingAddressLine1": "Terez krt",
        "billingAddressLine2": "Terez krt",
        "billingAddressLine3": "Terez krt",
        "billingPostalCode": "1067",
        "billingState": "VI",
        "payerBirthday": "19900101"
    },
    "billingRecipientData": {
        "recipientAccount": "DE89370400440532013000",
        "recipientLastName": "CHINA",
        "recipientFirstName": "Mieville",
        "recipientMiddleName": "Tom",
        "recipientCombinedName": "CHINA Mieville",
        "recipientIdType": "IDTP1",
        "recipientIdNumber": "792209292",
        "recipientCity": "BUD",
        "recipientCountry": "348",
        "recipientAddressLine1": "Terez krt",
        "recipientPostalCode": "1067",
        "recipientState": "VI",
        "recipientBirthday": "19900101"
    }
}'

Ejemplo de respuesta

{
  "errorCode": 0,
  "errorMessage": "Successful",
  "orderId": "0a4eaae8-653a-71a9-8259-46fc00a8ea58",
  "formUrl": "https://dev.bpcbt.com/payment/merchants/ecom/payment.html?mdOrder=0a4eaae8-653a-71a9-8259-46fc00a8ea58&language=en",
  "orderNumber": "2009"
}

Importe de comisión

Para obtener el importe de comisión por transferencia de dinero utilice la solicitud https://dev.bpcbt.com/payment/rest/api/p2p/verifyP2P.do.

La estructura de la solicitud supone la presencia del bloque fromCard para transmitir atributos de tarjeta para débito y del bloque toCard para transmitir atributos de tarjeta para acreditación.

Dependiendo de los procesos de negocio, al realizar transferencia de tarjeta a tarjeta pueden ser posibles las siguientes variantes:

• Al pasarela de pagos se transmiten datos de tarjeta de débito y datos de tarjeta de acreditación de fondos monetarios. En este caso en la solicitud deben estar presentes ambos bloques de parámetros — fromCard y toCard.
• Si la acreditación a tarjeta se realiza por sistema externo, entonces al pasarela de pagos se transmiten solo datos de tarjeta de débito. En este caso debe estar completado solo un bloque de parámetros — fromCard
• Si el débito de tarjeta se realiza por sistema externo, entonces al pasarela de pagos se transmiten solo datos de tarjeta de acreditación. En este caso debe estar completado solo un bloque de parámetros — toCard

Al ejecutar la solicitud es necesario utilizar el encabezado: Content-Type: application/json

Parámetros de solicitud

El bloque fromCard incluye los siguientes parámetros:

El bloque toCard incluye los siguientes parámetros:

A continuación se muestran los parámetros del bloque billingPayerData (datos sobre la dirección de registro del cliente).

A continuación se presentan los parámetros del bloque billingRecipientData (datos sobre el destinatario).

Parámetros de respuesta

El bloque feeDescriptionList incluye los siguientes parámetros:

Ejemplos

Ejemplo de solicitud

curl -X POST 'https://dev.bpcbt.com/payment/rest/api/p2p/verifyP2P.do'
-H 'Content-Type: application/json'
--data-raw '{
  "username":"test_user",
  "password":"test_user_password",
  "orderId": "0a4eaae8-653a-71a9-8259-46fc00a8ea58",
  "fromCard": {
    "cardholderName": "TEST CARDHOLDER",
    "cvc": "123",
    "expirationMonth": 12,
    "expirationYear": 2030,
    "pan": "5000001111111115"
  },
  "toCard": {
    "pan": "4000001111111118"
  },    
  "amount" : 50000
}'

Ejemplo de respuesta

{
  "errorCode": 0,
  "errorMessage": "Successful",
  "feeDescriptionList: [ {
    "feeAmount": 500,
    "feeCurrency": "978",
    "feeDescription": "Acquirer fee"
  } ]
}

Comisión por transferencia P2P por vinculación

Para obtener el monto de la comisión al transferir fondos por vinculación, utilice la solicitud https://dev.bpcbt.com/payment/rest/api/p2p/verifyP2PByBinding.do.

Al ejecutar la solicitud es necesario utilizar el encabezado: Content-Type: application/json

Parámetros de la solicitud

El bloque fromCard incluye los siguientes parámetros:

El bloque toCard incluye los siguientes parámetros:

Parámetros de la respuesta

Ejemplos

Ejemplo de solicitud

curl --location --request POST 'https://dev.bpcbt.com/payment/rest/api/p2p/verifyP2PByBinding.do' \
--header 'Content-Type: application/json' \
--data-raw '{
    "username": "test_user",
    "password": "test_user_password",
    "orderId": "fa71bf70-7c81-484e-a6fc-7db7e4283b2a",
    "bindingId": "4d792471-cee0-742c-922d-a265072e6148",
    "fromCard": {
        "seToken": "ofVx1r3aIJ3Mlx3nkfeOIJgFOnwfsgFK+V6Yzm+KxJgsq19l74GChhX0We/LEFq78Rhn9uFAEZGdeyDhnIc/KfuvObf0EzoDA65Uj1Z8FjwWyjnEwTBHZL4KmdFBCSk8jLxHt70mXwyjiHYyCVH1fT/UVOnsrkZVGrqmEG4MTi5dX9Znzf24DwRg4iezvdT8vf0dUW5lJdvY1tgOsOnBulwy6kH/YbHVsnR6yxO6d6IsdnT5f8PxaB+7ZyUqgrd6VA88FGJKJgdoxk4721pqKSG5dYroLJG96s23EDJ2Hpi4e9wU2rP7E6dlFw+qzATqX/eaJbaQ9eakkdMWnkj7aQ=="
    },
    "toCard": {
        "cardholderName": "IVAN IVANOV",
        "cvc": "123",
        "expirationMonth": 12,
        "expirationYear": 2024,
        "pan": "5555555555555599"
    },
    "amount": 1000,
    "currency": "978",
    "clientId": "123",
    "fromCard": {
        "bindingId": "fd3afc57-c6d0-4e08-aaef-1b7cfeb093dc"
    },
    "toCard": {
        "pan": "4000001111111118"
    }
}'

Ejemplo de respuesta

{
  "errorCode" : 0,
  "errorMessage" : "Successful",
  "feeDescriptionList" : [ {
    "feeAmount" : 10,
    "feeCurrency" : "978",
    "feeDescription" : "Acquirer fee"
  } ]
}

Transferencia P2P

Para realizar una transferencia monetaria de tarjeta a tarjeta utilice la solicitud https://dev.bpcbt.com/payment/rest/api/p2p/performP2P.do.

Al ejecutar la solicitud es necesario utilizar el encabezado: Content-Type: application/json

La estructura de la solicitud performP2P.do supone la presencia del bloque fromCard para transmitir atributos de la tarjeta para débito y del bloque toCard para transmitir atributos de la tarjeta para acreditación. Dependiendo de los procesos de negocio definidos para el banco y la tienda, al realizar la transferencia de tarjeta a tarjeta pueden ser posibles las siguientes variantes.

• La tienda transmite al gateway datos de la tarjeta de débito y datos de la tarjeta de acreditación de fondos monetarios. En este caso en la solicitud deben estar presentes ambos bloques de parámetros — fromCard y toCard.
• Si la acreditación a la tarjeta es realizada por un sistema externo (operación AFT), entonces la tienda transmite al gateway solo datos de la tarjeta de débito. En este caso debe haber solo un bloque de parámetros – fromCard
• Si el débito de la tarjeta es realizado por un sistema externo (operación OCT), entonces la tienda transmite al gateway solo datos de la tarjeta de acreditación. En este caso debe haber solo un bloque de parámetros – toCard

Parámetros de la solicitud

Valores posibles del parámetro tii:

Descripción de los parámetros del objeto shippingPayerData:

Descripción de los parámetros del objeto preOrderPayerData:

Descripción de los parámetros del objeto orderPayerData.

A continuación se muestran los parámetros del bloque billingPayerData (datos sobre la dirección de registro del cliente).

A continuación se presentan los parámetros del bloque billingRecipientData (datos sobre el destinatario).

El bloque fromCard incluye los siguientes parámetros:

Al realizar pagos utilizando tokens (APPLE, SAMSUNG, GOOGLE) en lugar de los datos de la tarjeta en el bloque fromCard se transmite:

A continuación se enumeran los parámetros del bloque threeDsAuthResult (datos sobre el resultado de autenticación 3 DS).

El bloque toCard incluye los siguientes parámetros:

En la autenticación por protocolo 3DS2 también se transmiten los siguientes parámetros:

Parámetros de respuesta

En la autenticación por protocolo 3DS2 en respuesta a la primera solicitud llegan los siguientes parámetros:

A continuación se presentan los parámetros que deben estar presentes en la respuesta, después de la solicitud repetida de pago y la necesidad de redirigir al cliente al ACS en la autenticación por protocolo 3DS2:

Parámetros del bloque statusResponse:

Para completar la transacción utilice el método /p2p/finishThreeDsVer2.do.

Ejemplos

Ejemplo de primera solicitud en caso de autenticación por protocolo 3DS2

curl -X POST 'https://dev.bpcbt.com/payment/rest/api/p2p/performP2P.do'
-H 'Content-Type: application/json'
--data-raw '{
  "username":"test_user",
  "password":"test_user_password",
  "orderId": "0a4eaae8-653a-71a9-8259-46fc00a8ea58",
  "amount" : "50000",
  "fromCard": {
    "vendor": "APPLE",
    "paymentToken": "eyJkZXZpY2VNYW51ZmFjdHVyZXJJZGVudGlmaWVyIjoiMDUwMTEwMDMwMjczIiwiY3VycmVuY3lDb2RlIjoiOTc4IiwiYXBwbGljYXRpb25FeHBpcmF0aW9uRGF0ZSI6IjI3MDEzMSIsInBheW1lbnREYXRhIjp7Im9ubGluZVBheW1lbnRDcnlwdG9ncmFtIjoiQUc5WW5Pak1YOUJXQUFSaElJOFBBb0FCRkE9PSJ9LCJwYXltZW50RGF0YVR5cGUiOiIzRFNlY3VyZSIsInRyYW5zYWN0aW9uQW1vdW50IjoxMDAsImFwcGxpY2F0aW9uUHJpbWFyeUFjY291bnROdW1iZXIiOiI1NTU1NTU1NTU1NTU1NTk5In0=",
    "decryptedToken":true,
    "protocolVersion":"ECv1"
  },
  "toCard" : {
    "pan" : "4111111111111111"
  },
  "params" : [
        {"name" : "recipientName", "Name" : "Surname"},
        {"name" : "payerName", "value" : "Name1 Surname1"},
        {"name" : "payerCity", "value" : "City"},
        {"name" : "payerCountry", "value" : "Country"},
        {"name" : "payerPostalCode", "value" : "777777"},
        {"name" : "payerState", "value" : "State"},
        {"name" : "payerAddress", "value" : "street, 18"]
  },        

}'

Ejemplo de segunda solicitud en caso de autenticación por protocolo 3DS2

curl -X POST 'https://dev.bpcbt.com/payment/rest/api/p2p/performP2P.do'
-H 'Content-Type: application/json'
--data-raw '{
  "username":"test_user",
  "password":"test_user_password",
  "orderId": "0a4eaae8-653a-71a9-8259-46fc00a8ea58",
  "fromCard": {
    "cardholderName": "TEST CARDHOLDER",
    "cvc": "123",
    "expirationMonth": 12,
    "expirationYear": 2030,
    "pan": "5000001111111115"
  },
  "toCard": {
    "pan": "4000001111111118"
  },    
  "amount" : 50000,
  "params" : [
        {"name" : "recipientName", "Name" : "Surname"},
        {"name" : "payerName", "value" : "Name1 Surname1"},
        {"name" : "payerCity", "value" : "City"},
        {"name" : "payerCountry", "value" : "Country"},
        {"name" : "payerPostalCode", "value" : "777777"},
        {"name" : "payerState", "value" : "State"},
        {"name" : "payerAddress", "value" : "street, 18"
  "threeDSServerTransId" : "3afc168a-94b4-4eb3-8e2e-80f6c186669d",
  "threeDSVer2FinishUrl" : "https://example.com/acs2/acs/3dsMethod"
}'

Ejemplo de solicitud de transferencia AFT

curl -X POST 'https://dev.bpcbt.com/payment/rest/api/p2p/performP2P.do'
-H 'Content-Type: application/json'
--data-raw '{
    "username": "test_user",
    "password": "test_user_password",
    "orderId": "0a4eaae8-653a-71a9-8259-46fc00a8ea58",
    "fromCard": {
        "cardholderName": "TEST CARDHOLDER",
        "cvc": "123",
        "expirationMonth": 12,
        "expirationYear": 2030,
        "pan": "5000001111111115"
    },
    "amountInput": "1000025",
    "type": "STANDARD"
}'

Ejemplo de respuesta a la primera solicitud en caso de autenticación por protocolo 3DS2

{
  "errorCode": 0,
  "is3DSVer2": true,
  "threeDSServerTransId": "3afc168a-94b4-4eb3-8e2e-80f6c186669d",
  "threeDSMethodURL": "https://example.com/acs2/acs/3dsMethod",
  "threeDSMethodURLServer": "https://example.com/3dsserver/api/v1/client/gather?threeDSServerTransID=3afc168a-94b4-4eb3-8e2e-80f6c186669d",
  "threeDSMethodDataPacked": "eyJ0aHJlZURTTWV0aG9kTm90aWZpY2F0aW9uVVJMIjoiaHR0cHM6Ly9hY3F1aXJlci5jb20vM2Rzc2VydmVyL2FwaS92MS9hY3Mvbm90aWZpY2F0aW9uP3RocmVlRFNTZXJ2ZXJUcmFuc0lEPTNhZmMxNjhhLTk0YjQtNGViMy04ZTJlLTgwZjZjMTg2NjY5ZCIsInRocmVlRFNTZXJ2ZXJUcmFuc0lEIjoiM2FmYzE2OGEtOTRiNC00ZWIzLThlMmUtODBmNmMxODY2NjlkIn0="
}

Ejemplo de respuesta a la segunda solicitud en caso de autenticación por protocolo 3DS2

{
  "errorCode": 0,
  "info": "Your order is proceeded, redirecting...",
  "acsUrl": "https://example.com/acs2/acs/creq",
  "is3DSVer2": true,
  "packedCReq": "eyJ0aHJlZURTU2VydmVyVHJhbnNJRCI6IjNhZmMxNjhhLTk0YjQtNGViMy04ZTJlLTgwZjZjMTg2NjY5ZCIsIm1lc3NhZ2VUeXBlIjoiQ1JlcSIsIm1lc3NhZ2VWZXJzaW9uIjoiMi4xLjAiLCJhY3NUcmFuc0lEIjoiOWM3NTkxMmEtZTg0NC00ODgyLWI5YzctYzZmYmMzNjIyNGQ3IiwiY2hhbGxlbmdlV2luZG93U2l6ZSI6IjA1In0"
}

Transferencia P2P por vinculación

Para realizar una transferencia de tarjeta a tarjeta utilizando vinculación, utilice la solicitud https://dev.bpcbt.com/payment/rest/api/p2p/performP2PByBinding.do.

Al ejecutar la solicitud es necesario utilizar el encabezado: Content-Type: application/json

Parámetros de solicitud

Valores posibles del parámetro tii:

El bloque fromCard incluye los siguientes parámetros:

A continuación se enumeran los parámetros del bloque threeDsAuthResult (datos sobre el resultado de autenticación 3 DS).

El bloque toCard incluye los siguientes parámetros:

Descripción de los parámetros del objeto shippingPayerData:

Descripción de los parámetros del objeto preOrderPayerData:

Descripción de los parámetros del objeto orderPayerData.

A continuación se muestran los parámetros del bloque billingPayerData (datos sobre la dirección de registro del cliente).

A continuación se presentan los parámetros del bloque billingRecipientData (datos sobre el destinatario).

Al autenticar por protocolo 3DS2 también se transmiten los siguientes parámetros:

Parámetros de respuesta

Al autenticar por protocolo 3DS2 en respuesta a la primera solicitud llegan los siguientes parámetros:

A continuación se presentan los parámetros que deben estar presentes en la respuesta, después de la solicitud repetida de pago y la necesidad de redirigir al cliente al ACS al autenticar por protocolo 3DS2:

Parámetros del bloque statusResponse:

Ejemplos

Ejemplo de solicitud

curl -X POST 'https://dev.bpcbt.com/payment/rest/api/p2p/performP2PByBinding.do'
-H 'Content-Type: application/json'
--data-raw '{ 
  "amountInput" : 1000,
  "fromCard" : {
     "seToken": "ofVx1r3aIJ3Mlx3nkfeOIJgFOnwfsgFK+V6Yzm+KxJgsq19l74GChhX0We/LEFq78Rhn9uFAEZGdeyDhnIc/KfuvObf0EzoDA65Uj1Z8FjwWyjnEwTBHZL4KmdFBCSk8jLxHt70mXwyjiHYyCVH1fT/UVOnsrkZVGrqmEG4MTi5dX9Znzf24DwRg4iezvdT8vf0dUW5lJdvY1tgOsOnBulwy6kH/YbHVsnR6yxO6d6IsdnT5f8PxaB+7ZyUqgrd6VA88FGJKJgdoxk4721pqKSG5dYroLJG96s23EDJ2Hpi4e9wU2rP7E6dlFw+qzATqX/eaJbaQ9eakkdMWnkj7aQ=="
  },
  "toCard": {
        "cardholderName": "TEST CARDHOLDER",
        "expirationMonth": 12,
        "expirationYear": 2029,
        "pan": "5555555555555599"
  },
  "orderId" : "3dbaf8bb-1d68-76b3-b4e6-784700f26b04",
  "password" : "test_user_password",
  "type" : "WITHOUT_TO_CARD",
  "username" : "test_user"
}'

Ejemplo de primera solicitud en caso de autenticación por protocolo 3DS2

curl -X POST 'https://dev.bpcbt.com/payment/rest/api/p2p/performP2PByBinding.do'
-H 'Content-Type: application/json'
--data-raw '{ 
  "amountInput" : 1000,
  "currency" : "978",
  "fromCard" : {
    "bindingId" : "fd3afc57-c6d0-4e08-aaef-1b7cfeb093dc"
  },
  "orderId" : "38b7a9e0-7cfa-46f7-8655-f206a8898e7a",
  "password" : "test_user_password",
  "type" : "WITHOUT_TO_CARD",
  "username" : "test_user",
  "params" : {
    "name" : "payerAddress",
    "value" : "payer Address"
  }
}'

Ejemplo de segunda solicitud en caso de autenticación por protocolo 3DS2

curl -X POST 'https://dev.bpcbt.com/payment/rest/api/p2p/performP2PByBinding.do'
-H 'Content-Type: application/json'
--data-raw '{ 
  "amountInput" : 1000,
  "currency" : "978",
  "fromCard" : {
    "bindingId" : "fd3afc57-c6d0-4e08-aaef-1b7cfeb093dc"
  },
  "orderId" : "38b7a9e0-7cfa-46f7-8655-f206a8898e7a",
  "password" : "test_user_password",
  "type" : "WITHOUT_TO_CARD",
  "username" : "test_user",
  "params" : {
    "name" : "payerAddress",
    "value" : "payer Address"
  },
  "threeDSServerTransId" : "f44d6d21-1874-45a5-aeb0-1c710dd6e134",
  "threeDSVer2FinishUrl" : "https://example.com/acs2/acs/3dsMethod"
}'

Ejemplo de respuesta

{
  "errorCode" : 0,
  "errorMessage" : "Successful",
  "info" : "Your order is proceeded, redirecting...",
  "redirect" : "https://example.com/?orderId=47743354-be15-7c70-b9ef-4bfc482e68dc&lang=en",
  "is3DSVer2" : false
}

Ejemplo de respuesta a la primera solicitud en caso de autenticación por protocolo 3DS2

{
  "errorCode": 0,
  "is3DSVer2": true,
  "threeDSServerTransId": "f44d6d21-1874-45a5-aeb0-1c710dd6e134",
  "threeDSMethodURLServer": "https://example.com/3dsserver/api/v1/client/gather?threeDSServerTransID=f44d6d21-1874-45a5-aeb0-1c710dd6e134",
}

Ejemplo de respuesta a la segunda solicitud en caso de autenticación por protocolo 3DS2

{
  "errorCode": 0,
  "info": "Your order is proceeded, redirecting...",
  "acsUrl": "https://example.com/acs2/acs/creq",
  "is3DSVer2": true,
  "packedCReq" : "eyJ0aHJlZURTU2VydmVyVHJhbnNJRCI6IjVmMzEyMjdlLTljZmQtNDQwYi1hNDNjLTE4NjljMzNhNGI5YiIsImFjc1RyYW5zSUQiOiI5YTQyYzQ4ZC1hNWRiLTQ3NjEtYmI4Mi05ZmY5MmM0NzZiM2QiLCJjaGFsbGVuZ2VXaW5kb3dTaXplIjoiMDQiLCJtZXNzYWdlVHlwZSI6IkNSZXEiLCJtZXNzYWdlVmVyc2lvbiI6IjIuMS4wIn0="
}

Transferencia instantánea P2P

Para realizar una transferencia instantánea P2P sin invocar una solicitud de registro de pedido, utilice la solicitud https://dev.bpcbt.com/payment/rest/api/p2p/instantPerformP2P.do.

Al ejecutar la solicitud es necesario utilizar el encabezado: Content-Type: application/json

La estructura de la solicitud instantPerformP2P.do presupone la presencia del bloque fromCard para transmitir los atributos de la tarjeta para el cargo y del bloque toCard para transmitir los atributos de la tarjeta para el abono. Dependiendo de los procesos de negocio definidos para el banco y la tienda, al realizar la transferencia de tarjeta a tarjeta pueden ser posibles las siguientes variantes.

• La tienda transmite a la pasarela los datos de la tarjeta de cargo y los datos de la tarjeta de abono de fondos monetarios. En este caso en la solicitud deben estar presentes ambos bloques de parámetros — fromCard y toCard.
• Si el abono a la tarjeta se produce por un sistema externo (operación AFT), entonces la tienda transmite a la pasarela solo los datos de la tarjeta de cargo. En este caso debe haber solo un bloque de parámetros – fromCard
• Si el cargo de la tarjeta se produce por un sistema externo (operación OCT), entonces la tienda transmite a la pasarela solo los datos de la tarjeta de abono. En este caso debe haber solo un bloque de parámetros – toCard

Parámetros de la solicitud

Valores posibles del parámetro tii:

Descripción de los parámetros del objeto shippingPayerData:

Descripción de los parámetros del objeto preOrderPayerData:

Descripción de los parámetros del objeto orderPayerData.

A continuación se muestran los parámetros del bloque billingPayerData (datos sobre la dirección de registro del cliente).

A continuación se presentan los parámetros del bloque billingRecipientData (datos sobre el destinatario).