Actualizar método de pago

Actualizar método de pago

Para este servicio se debe consumir el siguiente endpoint:

A continuación, se muestra el paso a paso para cancelar  una suscripción en nuestro API de forma exitosa:

1. Crear el objeto JSON a enviar

El objeto json debe tener la siguiente estructura:

Ejemplo de JSON a enviar en el request
  1. {
  2.   "subscriptionId": "id returned when subscription was created",
  3.   "merchantId": "your merchantid",
  4.   "secret": "your secret",
  5.   "user": "Some user name",
  6.   "token": "New token to add"
  7. }

A continuación, se muestra la descripción de los parámetros:

  1. subscriptionId: Es el identificador que se recibe en la respuesta cuando se crea una suscripción
  2. secret: secret provisto por GreenPay.
  3. merchant: merchantId provisto por GreenPay.
  4. user: Usuario que actualizará la suscripción.
  5. token: El token nuevo que reemplazará al que contiene la suscripción.

Consideraciones

El parámetro “user” es para llevar la auditoría de los usuarios que cambian el método de pago.

2. Enviar la solicitud de actualización del método de pago

Se debe enviar una solicitud HTTP de tipo POST al endpoint para cambiar el método de pago con el objeto json que contiene los datos de la suscripción.

Una vez que se ha enviado la solicitud de actualización y esta se haya realizado con éxito, se obtiene un objeto de tipo JSON como respuesta.

Al recibir esta respuesta, el parámetro que se debe obtener del objeto JSON es el “body”, ya que este contiene el resultado del cambio del método del pago. En la siguiente imagen se muestra un ejemplo de la respuesta que se recibe:

Ejemplo de respuesta exitosa
  1. {
  2.   "code": 200,
  3.   "status": "SUCCESS",
  4.   "result": {
  5.       "id": "3",
  6.       "merchant_id": "143b28c9-32ad-4635-8ed8-d6abfb6863a0",
  7.       "status": "ACTIVE",
  8.       "user_id": "Aaron",
  9.       "user_type": 1,
  10.       "card_tokens": [
  11.           "bf0bd94a-a4e7-4ef6-96c6-2350f3963f93"
  12.       ],
  13.       "purchase_order": {
  14.           "secret": "QUY5MzBEMkRDMzVCMDFCRDc2NzEwRjZCQjE3NjhFNkE0NjhEQ0MxRjkxQzkzMjAwNzVDNUVGNkY5RTc0N0M0NzkzNUEyQUZFQjczMEYyODEyRjJEMDc5Q0ExNTk1NTA0NjdCMkNBODg1N0Q4MzY2MjI0NEREMUVGQjk4NTcwMzg=",
  15.           "terminal": "deKokoTest-eb29-BNCR-CRC",
  16.           "description": "subscription description",
  17.           "currency": "CRC",
  18.           "initialPayment": {
  19.               "amount": 100,
  20.               "description": "some set up description"
  21.           },
  22.           "subscription": [
  23.               {
  24.                   "startDate": 1536991200000,
  25.                   "endDate": 1544853600000,
  26.                   "amount": 10,
  27.                   "cadence": {
  28.                       "mode": "EVERY",
  29.                       "unit": "MONTH",
  30.                       "every": 1,
  31.                       "day": 15
  32.                   }
  33.               }
  34.           ],
  35.           "optional": {
  36.               "key": "value",
  37.               "key1": "value1"
  38.           }
  39.       },
  40.       "next_payment": null,
  41.       "enabled": true,
  42.       "inserted_at": "2018-12-21T20:55:06.299Z",
  43.       "updated_at": "2018-12-21T22:01:11.341Z",
  44.       "general_info": {
  45.           "user": "UserBot"
  46.       }
  47.   },
  48.   "errors": []
  49. }

A continuación, se muestra un ejemplo en javascript del envío de la solicitud al endpoint de suscripciones. Esta función también obtiene el “body” del objeto tipo JSON que se recibe como respuesta.

Ejemplo de código de envío del Post request
  1. var url = "https://sandbox-merchant.greenpay.me/subscriptions/update/card_token"

  3. var data = {
  4.    "subscriptionId": "b69cd5773eac06bf25a702bac02e8079",
  5.    "secret": "QUY5MzBEMkRDMzVCMDFCRDc2NzEwRjZCQjE3NjhFNkE0NjhEQ0MxRjkxQzkzMjAwNzVDNUVGNkY5RTc0N0M0NzkzNUEyQUZFQjczMEYyODEyRjJEMDc5Q0ExNTk1NTA0NjdCMkNBODg1N0Q4MzY2MjI0NEREMUVGQjk4NTcwMzg=",
  6.    "merchantId": "143b28c9-32ad-4635-8ed8-d6abfb6863a0",
  7.    "user": "UserBot",
  8.    "token": "bf0bd94a-a4e7-4ef6-96c6-2350f3963f93"
  9. }

  11. var unirest = require("unirest");

  13. var req = unirest("POST", url);

  15. req.headers({
  16.    "cache-control": "no-cache",
  17.    "Content-Type": "application/json"
  18. });

  20. req.type("json");
  21. req.send(data);

  23. req.end(function (res) {
  24.    if (res.error) throw new Error(res.error);
  25.    console.log(res.body);
  26. });

3. Posibles errores a recibir

  1. Merchant doesn't exist.

Si se intenta actualizar  una suscripción con credenciales incorrectas, la respuesta retornada será la siguiente.

Ejemplo de respuesta - Credenciales invalidas
  1. {
  2.   "code": 500,
  3.   "status": "FAIL",
  4.   "result": [],
  5.   "errors": [
  6.       ""Merchant doesn't exist"."
  7.   ]
  8. }


2.Subscription don't exist.

Si se intenta actualizar una suscripción inactiva o que no se encuentra en alguno de los estados (Active, Pending u On Hold) , la respuesta retornada será la siguiente.

Ejemplo de respuesta - Suscripción no existe
  1. ​{
  2.   "code": 500,
  3.   "status": "FAIL",
  4.   "result": [],
  5.   "errors": [
  6.       "Subscription don't exist."
  7.   ]
  8. }




    • Related Articles

    • Actualizar monto

      Para este servicio se debe consumir el siguiente endpoint: https://sandbox-merchant.greenpay.me/subscriptions/update A continuación, se muestra el paso a paso para actualizar el monto de  una suscripción en nuestro API de forma exitosa: 1. Crear el ...

    • Actualizar token de tarjeta

      Consideraciones Para utilizar el servicio de tokenización se debe tomar en cuenta los siguiente: Utilizar el servicio en los endpoints:  Sandbox: https://sandbox-checkout.greenpay.me/tokenize/update ...

    • Invocar API de pago

      Consideraciones Para invocar el api de pagos se debe considerar lo siguiente Utilizar el servicio en los endpoints:  Sandbox: https://sandbox-checkout.greenpay.me/kount Producción: https://checkout.greenpay.me/kount Tener una session y token de una ...

    • Respuesta de pago en webhook

      1. Descripción Si el comercio require recibir las respuesta de los pagos o tokenización de tarjetas en un backend, ya sea, para actualizar pedidos, información o simplemente almacenar la respuesta en base de datos como respaldo, entonces debe ...

    • Crear orden de pago

      Consideraciones Una orden de pago se crea para indicar al API de pago que se efectuará una transacción por el motivo de los datos indicados en la orden. Para esto se debe tener las siguientes consideraciones: Utilizar el servicio en los endpoints: En ...