CheckoutForm V2

En este apartado encontrará información acerca del checkoutform V2 y las respuestas del callback del checkoutform con 3DS y sin 3DS

Consideraciones

Para poder hacer uso del checkoutform de GreenPay 2.0 se debe haber creado previamente una orden de pago Crear orden de pago V2
Se debe usar la sesión generada por la orden de pago y colocarla en la url del checkoutform de GreenPay 2.0 de la siguiente manera

En sandbox: https://checkoutform.greenpaysbx.me/v2/655bdf13-dcb1-44cb-a3ee-ed5e907a6ca1

En producción: https://checkoutform.greenpay.me/v2/655bdf13-dcb1-44cb-a3ee-ed5e907a6ca1

Donde 655bdf13-dcb1-44cb-a3ee-ed5e907a6ca1 es la sesión devuelta por GreenPay V2 al generar la orden de pago

Callback

El checkoutform puede responder con los datos de la respuesta de la transacción por medio de un callback que se envia al crear la orden de pago.

El checkoutform esta disponible para funcionar con 3DS ó sin 3DS, las respuestas del callback en cada caso son diferentes, a continuación se mostrará ejemplos de cada uno

Open image-20241028-170555.png

El callback responderá a la url que agrego como callback y agregará la respuesta en base64 de la siguiente manera

http://localhost:3000/eyJzdGF0dXMiOjIwMCwib3JkZXJJZCI6ImNvbXByYS0yMDI0LTEwLTI4LVVTRC05MjgiLCJhdXRob3JpemF0aW9uIjoiODMxMDAwIiwiYW1vdW50IjozMSwiY3VycmVuY3kiOiJVU0QiLCJ0b2tlbiI6ImY0NjUyOGMwLTk1NGYtMTFlZi04NTAwLTI3ZjFhZDY5MWY3MSIsImludGVybmFsUmVmIjo2NTg3NDA4MTY0MjY0LCJ0cmFuc2FjdGlvbklkIjoiMTc1OGFmNzQtMzAyYy00NjAyLThmNDAtNjljMzBkZmYzOWNjIiwiZXJyb3JzIjpbXSwibGFzdDQiOiIxODE1IiwiYnJhbmQiOiJNYXN0ZXJjYXJkIiwic3RhdHVzQ29kZSI6MjAwfQ==

Respuesta del callback sin 3DS

Si esta usando el servicio de checkoutform V2 de GreenPay la respuesta del callback tiene la siguiente estructura

Respuesta exitosa

{
   "status":200,
   "orderId":"compra-2024-10-28-USD-928",
   "authorization":"831000",
   "amount":31,
   "currency":"USD",
   "token":"f46528c0-954f-11ef-8500-27f1ad691f71",
   "internalRef":6587408164264,
   "transactionId":"1758af74-302c-4602-8f40-69c30dff39cc",
   "errors":[],
   "last4":"1815",
   "brand":"Mastercard",
   "statusCode":200
}

Respuesta fallida

{
   "status":400,
   "errors":[
      "Error response here"
   ]
}

Respuesta del callback con 3DS

Debe tener en cuenta si utiliza el servicio de checkoutform con 3DS o no, porque las respuestas del callback son diferentes

Respuesta exitosa

{
  "id": "7301477069456173304951",
  "code": "0c03441a-33d5-44cf-8d8a-84c1cad46992",
  "status": "AUTHENTICATION_SUCCESSFUL",
  "authenticationTransactionId": "355fc5RZAUYv3hKAn1k0",
  "acsTransactionId": "8328baed-7537-43aa-bf5d-407af2b88050",
  "paresStatus": "Y",
  "threeDSServerTransactionId": "26b49c8b-f3e6-41ef-a95d-f906c4554497",
  "veresEnrolled": "Y",
  "directoryServerTransactionId": "c037f78e-075c-4ccf-b79a-9a7616f1d750",
  "error": {},
  "consumerAuthenticationInformation": {
    "acsTransactionId": "8328baed-7537-43aa-bf5d-407af2b88050",
    "authenticationTransactionId": "355fc5RZAUYv3hKAn1k0",
    "cavv": "AJkBBkhgQQAAAE4gSEJydQAAAAA=",
    "ecommerceIndicator": "vbv",
    "eci": "05",
    "eciRaw": "05",
    "paresStatus": "Y",
    "specificationVersion": "2.2.0",
    "threeDSServerTransactionId": "26b49c8b-f3e6-41ef-a95d-f906c4554497",
    "veresEnrolled": "Y",
    "xid": "AJkBBkhgQQAAAE4gSEJydQAAAAA=",
    "directoryServerTransactionId": "c037f78e-075c-4ccf-b79a-9a7616f1d750",
    "acsOperatorID": "MerchantACS",
    "acsReferenceNumber": "Cardinal ACS"
  },
  "transaction": {
    "id": "0c03441a-33d5-44cf-8d8a-84c1cad46992",
    "status": "SUCCESSFUL",
    "description": "API-V2-CRC",
    "authorization": "831000",
    "webhook_url": "https://webhook.site/65abb7cf-6502-4df6-b3af-cc5893527c87",
    "orderReference": "API-V2-CRC-6885"
  }
}

Respuesta fallida