########
Payments
########

Credit Card Payment
*******************

Aplicar el cobro con la tarjeta de crédito.

Resource URL
============

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

	:param client_id: ID del cliente.
	:param format: json o xml.

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

	:<json int bank_id: ID del banco.
	:<json float amount: Cantidad a cobrar.
	:<json obj card: Datos de la tarjeta de crédito. Descripción detallada más abajo.

	:<json string token: (opcional) Token de la tarjeta.
	:<json string device_session_id: (opcional) ID del dispositivo para el token.
	:<json string ip: (opcional) IP del dispositivo.
	:<json string cookie: (opcional) Token de la Cookie del dispositivo.
	:<json string user_agent: (opcional) Datos del navegador Web del dispositivo.

	:>json int orden: Número de orden.
	:>json int transaction: Número de la transacción.
	:>json int authorize: Si es 0 el cobro no se autorizo.
	:>json int key_response: Clave de respuesta del procesador de pagos.
	:>json string message: Mensaje del procesador de pagos.
	:>json string processor: Nombre del procesador de pagos.
	:>json int folio: Folio del documento de pago.
	:>json obj document: Objeto del documento.

	:statuscode 200: No hay errores.
	:statuscode 400: Algún parámetro no se envió correctamente.
	:statuscode 401: Token no válido o no enviado.
	:statuscode 404: Cliente no localizado.
	

	**card object**:

	:<json string account: Número de la tarjeta de crédito.
	:<json string cvv: Código de seguridad.
	:<json int expiration_year: Año de expiracion.
	:<json int expiration_month: Mes de expiracion.
	:<json string holder: Nombre impreso en la tarjeta de crédito.

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

Example request
===============

.. sourcecode:: http

	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 )

.. literalinclude:: example_payment_body_01.json
	:language: json

Example Response
================

.. sourcecode:: http

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

.. literalinclude:: example_payment_01.json
	:language: json

Example XML
===========

Example request
---------------

.. sourcecode:: http

	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 )

.. literalinclude:: example_payment_body_01.xml
	:language: xml

Example Response
----------------

.. sourcecode:: http

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

.. literalinclude:: example_payment_01.xml
	:language: xml