Payments

Credit Card Payment

Aplicar el cobro con la tarjeta de crédito.

Resource URL

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

Parámetros:

client_id – ID del cliente.
format – json o xml.

Encabezados de solicitud:

Authorization – Token del usuario.
Content-Type – Formato de los datos a enviar por el body.

Objeto JSON de solicitud:

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.

Objeto JSON de respuesta:

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.

Códigos de Status:

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:

Objeto JSON de solicitud:

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 https://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

Example request

POST https://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>

Example Response

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>