Payments¶

Resource URL¶

POST http://api.next-cloud.mx/v1/client/(int: client_id)/payment.(format)¶

Parameters:	client_id – ID del cliente. format – json o xml.
Request Headers:
	Authorization – Token del usuario. Content-Type – Formato de los datos a enviar por el body.
Request JSON Object:
	bank_id (int) – ID del banco. amount (float) – Cantidad a cobrar. card (obj) – Datos de la tarjeta de crédito. Descripción detallada más abajo. token (string) – (opcional) Token de la tarjeta. device_session_id (string) – (opcional) ID del dispositivo para el token. ip (string) – (opcional) IP del dispositivo. cookie (string) – (opcional) Token de la Cookie del dispositivo. user_agent (string) – (opcional) Datos del navegador Web del dispositivo.
Response JSON Object:
	orden (int) – Número de orden. transaction (int) – Número de la transacción. authorize (int) – Si es 0 el cobro no se autorizo. key_response (int) – Clave de respuesta del procesador de pagos. message (string) – Mensaje del procesador de pagos. processor (string) – Nombre del procesador de pagos. folio (int) – Folio del documento de pago. document (obj) – Objeto del documento.
Status Codes:	200 OK – No hay errores. 400 Bad Request – Algún parámetro no se envió correctamente. 401 Unauthorized – Token no válido o no enviado. 404 Not Found – Cliente no localizado.

card object:

Request JSON Object:
	account (string) – Número de la tarjeta de crédito. cvv (string) – Código de seguridad. expiration_year (int) – Año de expiracion. expiration_month (int) – Mes de expiracion. holder (string) – Nombre impreso en la tarjeta de crédito.

document object: :>json string key: Clave del documento. :>json int folio: ID del documento.

Example request¶

POST http://api.next-cloud.mx/v1/client/1/payment.json HTTP/1.1
Host: api.next-cloud.mx
Accept: application/json
Content-Type: application/json
Authorization: Token ( token del usuario )

{
	"bank_id":38,
	"amount":1,
	"card":{
		"cvv":"256",
		"expiration_month":"9",
		"account":"4111111111111111",
		"holder":"Algun nombre",
		"expiration_year":"2019"
	}
}

Example Response¶

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json
Allow: POST, OPTIONS

{
	"authorize": "039884",
	"orden": 245866764952,
	"folio": 2564198,
	"transaction": 245866764952,
	"key_response": 1,
	"message": "Approved.",
	"document": {
		"folio": 17879,
		"key": "ANTMC"
	},
	"processor": "PAYWORKS"
}

Example XML¶

POST http://api.next-cloud.mx/v1/client/1/payment.xml HTTP/1.1
Host: api.next-cloud.mx
Accept: application/xml
Content-Type: application/xml
Authorization: Token ( token del usuario )

<?xml version="1.0" encoding="UTF-8"?>
<root>
	<amount>1</amount>
	<bank_id>38</bank_id>
	<card>
		<cvv>256</cvv>
		<expiration_month>9</expiration_month>
		<account>4111111111111111</account>
		<holder>Algun nombre</holder>
		<expiration_year>2019</expiration_year>
	</card>
</root>

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/xml; charset=utf-8
Allow: POST, OPTIONS

<?xml version="1.0" encoding="UTF-8"?>
<root>
	<authorize>039884</authorize>
	<document>
		<folio>17879</folio>
		<key>ANTMC</key>
	</document>
	<folio>2564198</folio>
	<key_response>1</key_response>
	<message>Approved.</message>
	<orden>245866764952</orden>
	<processor>PAYWORKS</processor>
	<transaction>245866764952</transaction>
</root>