MercadoPago Argentina -

Personalizar el botón de compra:

HTML del botón:

<form target="_top" action="https://www.mercadopago.com/mla/buybutton" method="post">
    <input type="image" src="https://www.mercadopago.com/org-img/MP3/buy_now_02.gif" 
      border="0" alt="Comprar Ahora">
    <input type="hidden" name="acc_id" value="xxx">
    <input type="hidden" name="enc" value="xxxxxxxxxxxxxxxxxxx">
    <input type="hidden" name="url_succesfull" value="http://www.suSitio.com/succesfull">
    <input type="hidden" name="url_process" value="http://www.suSitio.com/process">
    <input type="hidden" name="url_cancel" value="http://www.suSitio.com/cancel">
    <input type="hidden" name="item_id" value="item1234">
    <input type="hidden" name="name" value="Item name">
    <input type="hidden" name="currency" value="ARG">
    <input type="hidden" name="price" value="10.0">
    <input type="hidden" name="shipping_cost" value="1.0">
    <input type="hidden" name="ship_cost_mode" value="FI">
    <input type="hidden" name="op_retira" value="B">
    <input type="hidden" name="extra_part" value="xxx">
    <input type="hidden" name="seller_op_id" value="xxx">
</form>

Para personalizarlo, puedes modificar:

Parámetro	Valor	Tipo	Caracteres
image	URL de la imagen del botón	Alfanumérico	500
acc_id	Número de cuenta. Averígualo en Configuración avanzada	Numérico	10
enc	Código validador de seguridad. Averígualo en Configuración avanzada	Alfanumérico	40
url_succesfull	URL a donde el comprador será redirigido cuando se acredite el pago	Alfanumérico	500
url_process	URL a donde el comprador será redirigido cuando el pago está en proceso	Alfanumérico	500
url_cancel	URL a donde el comprador será redirigido cuando cancele el pago	Alfanumérico	500
item_id	Código del producto	Alfanumérico	200
name	Nombre del producto	Alfanumérico	100
currency	El código de la moneda. Para Argentina: " ARG"	Alfabético	5
price	Precio del producto	Numérico	14
shipping_cost	Costo de envío	Numérico	14
ship_cost_mode (1)	Tipo de costo de envío: FI (Costos específicos para el producto); FS (Envío gratis); DS (Envío digital); GS (Costos globales); EB (Los compradores lo ingresan).	Alfabético	4
op_retira (1)	Preferencias de envío: S (Hago envíos); O (El comprador retira el producto en mi domicilio); B (las dos anteriores)	Alfabético	1
extra_part	Parámetros adicionales, agregados por el vendedor en el carrito.	Alfanumérico	600
seller_op_id	Código de referencia único de la operación	Alfanumérico	100

(1) Para quitar los pasos de preferencias de envío del flujo de pagos no agregues ningún valor al parámetro.

Generar un botón con código de seguridad avanzado

Encripta todos estos parámetros utilizando el algoritmo MD5 y agrega el código resultante en el parámetro "enc".

acc_id
item_id
price
currency
ship_cost_mode
amount1 (el número puede variar de 1 a 10)
currency_id1 (el número puede variar de 1 a 10)
dol_amount1 (el número puede variar de 1 a 10)
token (como es privado, no se ve en el HTML generado. Debes obtenerla en Configuración avanzada)

Cada código de seguridad avanzado es único y debe ser generado para cada operación.

Comunicación del estado del pago

Tendrás que indicar las páginas en las que quieres que te informemos tus pagos (online y offline). Obtendrás una clave para realizar las consultas.

Encontrarás estos datos en Configuración avanzada.

Para avisarte el estado de un pago, MercadoPago
ofrece 3 modos de comunicación:

1- Online
2- Offline
3- Consulta del estado de un pago (sonda)

Los 3 modos devuelven estos datos:

Parámetro	Valor	Tipo	Caracteres
seller_op_id	Código de referencia único de la operación	Alfanumérico	100
mp_op_id	Código de referencia de la operación en MercadoPago	Numérico	10
acc_id	Número de cuenta. Averígualo en Configuración avanzada	Numérico	10
status	Estado del pago: A: acreditado; P: pendiente; C: cancelado o R: rechazado	Alfabético	1
item_id	Código del producto	Alfanumérico	200
name	Nombre del producto	Alfanumérico	100
price	Precio del producto	Numérico	14
shipping_amount	Costo de envío	Numérico	14
additional_amount (1)	Parámetro de compatibilidad con la versión anterior de MercadoPago.	Numérico	14
total_amount	Pago total del comprador	Numérico	14
extra_part	Parámetros adicionales, agregados por el vendedor en el carrito.	Alfanumérico	600
payment_method	Medio de pago: TCO (Tarjetas de crédito online); OFF (Medios offline: Pago Fácil, Rapipago, Red Link, Banelco, BaproPagos, PagoMisCuentas, transferencia bancaria, depósito bancario, etc.).	Alfabético	3

(1) Su valor será siempre 0 (cero).

Comunicación online

Se realiza a través de un pedido al finalizar la operación (método POST) que lleva los datos necesarios para que identifiques el estado del pago.

Si la comunicación falla, el sistema guardará la información para reenviarla cuando el problema se resuelva.

Comunicación offline

Informa el estado de los pagos pendientes o de los que no pudieron informarse online.

Cuando los pagos pendientes sean aprobados o rechazados, MercadoPago te lo informará por método POST a la página de respuesta offline.

Si la comunicación falla, el sistema seguirá intentando hasta que el problema se resuelva.

Consulta del estado de un pago (sonda)

Es un WebService que sirve para ver el estado de un pago en cualquier momento.

Para llamar al WebService debes usar el método POST. En él se pasarán los datos necesarios, entre ellos, el dato 'sonda_key' que debe tener como valor el token de tu cuenta.

Estos son los parámetros:

<form target="_top" action="https://www.mercadopago.com/mla/sonda" method="post">
    <input type="submit" value="ConsultarSonda">
    <input type="hidden" name="mp_op_id" value="xxx">
    <input type="hidden" name="seller_op_id" value="xxx">
    <input type="hidden" name="acc_id" value="xxx">
    <input type="hidden" name="sonda_key" value="xxxxxxxxxxxxxxxxxxxx">
</form>

Cada parámetro está definido por:

Parámetro	Valor	Tipo	Caracteres
seller_op_id	Código de referencia único de la operación	Alfanumérico	100
mp_op_id	Código de referencia de la operación en MercadoPago	Numérico	10
acc_id	Número de cuenta. Averígualo en Configuración avanzada	Numérico	10
sonda_key	Token. Averígualo en Configuración avanzada	Alfanumérico	32

'mp_op_id' y 'seller_op_id' no pueden ser ambos nulos.

'acc_id' y 'sonda_key' no pueden estar vacíos.

Este WebService devolverá un XML con datos que incluyen el estado de la validación del pedido ("mensaje") y sus posibles valores ("OK" o un mensaje de error).

Ejemplo de XML para un pago aprobado:

<?xml version="1.0" encoding="ISO-8859-1"?>
<result>
	<message>OK</message>
	<operation>
		<seller_op_id>xxx</seller_op_id>
		<mp_op_id>xxx</mp_op_id>
		<acc_id>xxx</acc_id>
		<status>A</status>
		<item_id>item1234</item_id>
		<name>Mi Producto</name>
		<price>199.0</price>
		<shipping_amount>21<
;/shipping_amount>
		<additional_amount>0</additional_amount>
		<total_amount>220</total_amount>
		<extra_part></extra_part>
		<payment_method>TCO</payment_method>
	</operation>
</result>

Ejemplo de XML para un pago pendiente:

<?xml version="1.0" encoding="ISO-8859-1"?>
<result>
	<message>OK</message>
	<operation>
		<seller_op_id>xxx</seller_op_id>
		<mp_op_id>xxx</mp_op_id>
		<acc_id>xxx</acc_id>
		<status>P</status>
		<item_id>item1234</item_id>
		<name>Mi Producto</name>
		<price>199.0</price>
		<shipping_amount>21</shipping_amount>
		<additional_amount>0</additional_amount>
		<total_amount>220</total_amount>
		<extra_part></extra_part>
		<payment_method>TCO</payment_method>
	</operation>
</result>

Ejemplo de XML para un pago rechazado:

<?xml version="1.0" encoding="ISO-8859-1"?>
<result>
	<message>OK</message>
	<operation>
		<seller_op_id>xxx</seller_op_id>
		<mp_op_id>xxx</mp_op_id>
		<acc_id>xxx</acc_id>
		<status>C</status>
		<item_id>item1234</item_id>
		<name>Mi Producto</name>
		<price>199.0</price>
		<shipping_amount>21</shipping_amount>
		<additional_amount>0</additional_amount>
		<total_amount>220</total_amount>
		<extra_part></extra_part>
		<payment_method>TCO</payment_method>
	</operation>
</result>