mPandco API Documentación v1.7.1

6.3. Generar intención de pago (API de facturación).

Este método permite crear una intención de pagó mediante un sistema de facturación para solicitar a un cliente.

Importante: En el parámetro “paymentintent[intent]” debe enviar el valor “request” y el parámetro “paymentintent[recipient]” es requerido, debe enviar el nombre del usuario destinatario que realizará el pago, puede usar el nombre de usuario (pizzaexpress), numero de teléfono (584120000010) y numero de identificación (V19123456).

URL: api/payment-intent/.json

Método HTTP: POST

Documentación completa de la API: Ir a la documentación

Datos mínimos a enviar:

{
    "paymentintent": {
        "intent": "request",
        "redirectUrls": {
            "returnUrl": "http://localhost:5000/payments/ExecutePayment.php?success=true&carId=200",
            "cancelUrl": "http://localhost:5000/payments/ExecutePayment.php?success=false&carId=200"
        },
        "transactions": {
            "0": {
                "amount": {
                    "total": "20"
                },
                "description": "Compra por eBay",
                "items": {
                    "0": {
                        "name": "telefono",
                        "price": "7.5"
                    }
                }
            }
        },
        "recipient": "V25550099"
    }
}

Ejemplo de petición:

curl -X POST \
  https://test.mpandco.com/api/payment-intent/.json \
  -H 'authorization: Bearer OAUTH-TOKEN' \
  -F 'paymentintent[intent]=request' \
  -F 'paymentintent[redirectUrls][returnUrl]=http://localhost:5000/payments/ExecutePayment.php?success=true&carId=200' \
  -F 'paymentintent[redirectUrls][cancelUrl]=http://localhost/payments/ExecutePayment.php?success=false&carId=200' \
  -F 'paymentintent[transactions][0][digitalAccountDestination]=demo01' \
  -F 'paymentintent[transactions][0][amount][total]=20' \
  -F 'paymentintent[transactions][0][amount][currency]=VES' \
  -F 'paymentintent[transactions][0][amount][details][shipping]=0' \
  -F 'paymentintent[transactions][0][amount][details][tax]=1.3' \
  -F 'paymentintent[transactions][0][amount][details][subTotal]=17.50' \
  -F 'paymentintent[transactions][0][description]=Compra por eBay' \
  -F 'paymentintent[transactions][0][invoiceNumber]=F00015' \
  -F 'paymentintent[transactions][0][items][0][name]=telefono' \
  -F 'paymentintent[transactions][0][items][0][quantity]=1' \
  -F 'paymentintent[transactions][0][items][0][sku]=P001' \
  -F 'paymentintent[transactions][0][items][0][price]=7.5' \
  -F 'paymentintent[transactions][0][items][0][currency]=VES' \
  -F 'paymentintent[recipient]=demo03'

Respuesta:

200 - Correcto. Retorna JSON de tipo ‘PaymentIntent’

Ejemplo de respuesta (200):

{
"id":"0f78eef2-ff02-11e8-a647-b62cbc289574",
"payer":{
   "payer_info":{
         "id":"0cac1d76-ff01-11e8-a647-b62cbc289574",
         "_data":{
"fullname":"584125550000"
        }
      }
   },
   "intent":"request",
   "state":"created",
   "redirect_urls":{
 "return_url":"http://localhost/payments/ExecutePayment.php?success=true&carId=200",
"cancel_url":"http://localhost/payments/ExecutePayment.php?success=false&carId=200",
    "history_responses":[

      ]
   },
   "total":{
      "currency":{
        "id":"VES"
      },
      "items":17.5,
      "shipping":0,
      "tax":1.3,
      "amount":18.8
   },
   "transactions":[
      {
         "id":"0f7a8104-ff02-11e8-a647-b62cbc289574",
         "amount":{
             "currency":{
                "id":"VES"
            },
            "total":20,
            "details":{
               "shipping":0,
               "tax":1.3,
               "sub_total":17.5
            }
         },
         "items":[
           {
               "name":"telefono",
               "quantity":1,
               "currency":{
                 "id":"VES"
               },
               "sku":"P001",
               "price":7.5
            }
         ],
         "description":"Compra por eBay",
         "invoice_number":"F00015"
      }
   ],
   "pay_tokens":[
     {
        "id":"0f7b8f72-ff02-11e8-a647-b62cbc289574",
        "_data":{
           "name":"J255500006-Pepitos House"
         }
     }
   ],
   "_links":{
     "self":{
        "href":"http://test.mpandco.com/api/payment-intent/show?id=0f78eef2-ff02-11e8-a647-b62cbc289574",
        "method":"GET"
      },
      "execute":{
        "href":"http://test.mpandco.com/api/payment-intent/execute/request?id=0f78eef2-ff02-11e8-a647-b62cbc289574",
        "method":"POST"
      }
   }
}

Al realizar una solicitud mediante el API de facturación, el cliente puede pagar de dos formas:

a) Mediante su teléfono: el cliente recibirá una notificación en su teléfono móvil donde se le indica que debe pagar la solicitud, una vez el cliente pague se llamará la dirección enviada en “redirect_urls.return_url” con el id de la intención de pago aprobada, usted debe obtener la intención con el enlace contenido en “_links.self” y verificar que el estatus sea “executed”.

b) Mediante el teclado numérico de su caja: Cada transacción retornará una lista con de tokens para pagar (pay_tokens), usted deberá mostrar una lista de los tokens para permitir seleccionar el origen de los fondos del cliente con un campo numérico de 4 dígitos, donde el cliente ingresará su pin de operaciones para autorizar el pago, al tener ambos datos deberá ejecutar el pago llamando el enlace “_links.execute”, tal como se indica en el paso 5.4.

6.4. Ejecutar intención de pago (API de facturación).

Ejecuta una intención de pago de tipo “request” autorizada por un cliente y abona el dinero al comercio.

URL: api/payment-intent/request.json