Preparar transacción
Integrar el botón en tu sitio web es muy sencillo, solo agrega dos scripts y un tag html para que el botón aparezca.
- El primer script lo debes agregar en tu cabecera de tu archivo y debes poner tu identificador de aplicación después de “appID=”. El identificador de aplicación lo encuentras en la configuración de tu aplicación en la página de Payphone Developer
<script> src=”https://pay.payphonetodoesposible.com/api/button/js?appId=TUIDDEAPLICACION“></script>
- El segundo script es el que te permitirá controlar las acciones de petición y respuesta del botón, lo debes insertar de igual forma en la cabecera:
window.onload = function() {
payphone.Button({
//token obtenido desde la consola de developer
token: "TU-TOKEN-DE-AUTENTICACION",
//PARÁMETROS DE CONFIGURACIÓN
btnHorizontal: true,
btnCard: true,
createOrder: function(actions){
//Se ingresan los datos de la transaccion ej. monto, impuestos, etc
return actions.prepare({
amount: 100,
amountWithoutTax: 100,
currency: "USD",
clientTransactionId: "identificador-único",
lang:"es"
}).then(function(paramlog){
console.log(paramlog);
return paramlog;
}).catch(function(paramlog2){
console.log(paramlog2);
return paramlog2;
});
},
onComplete: function(model, actions){
}
}).render("#pp-button");
}
Ajustes del Express Checkout
En nuestro Express Checkout puedes configurar aspectos gráficos y de comportamiento del botón:
- btnHorizontal: Si este parámetro se encuentra en true la disposición de los botones se mostrará de manera horizontal, si se encuentra en false se mostrará de manera vertical.
- btnCard: Si este parámetro se encuentra en true, se mostrarán los botones de Visa y Mastercard para el pago directo sin necesidad del app Payphone.
Parametros en la petición
Los datos de transacción los usas para detallar los montos a cobra, la moneda, datos del cliente y referencias que necesites enviar para el pago :
Valor total de la factura a cobrar, es la suma de amountWithTax, amountWithoutTax, Tax, service y tip.
Valor que no graba impuesto.
X - solo en caso de que se cobre valores con Iva, es obligatorio si no se cobran valores con Iva
Valor que si graba impuesto, sin el impuesto incluido.
X - solo en caso de que se cobre valores sin Iva, es obligatorio si se cobran valores con Iva
X - solo en caso de que se cobre valores sin Iva, es obligatorio si se cobran valores con Iva
Identificador de transacción, debes generarlo, es un identificador único.
Identificador de sucursalr que realiza el cobro, este parámetro se puede obtener en el apartado "Solicitud de compañia" de la página de PayPhone Developer, en el botón lista.
Referencia del pago que puedes enviar.
Número de Teléfono del cliente, si no lo envías el botón lo solicitará al cliente.
Correo electrónico del cliente, si no lo envías el botón lo solicitará al cliente.
Número de identificación del cliente, si no lo envías el botón lo solicitará al cliente.
- El tercer elemento que debes agregar es una etiqueta DIV que debes ubicar en la sección donde quieras que aparezca el botón de pago.
<div id="pp-button"></div>
Los valores a cobrar son enteros y se deben multiplicar por 100, por ejemplo $1 dólar = 100. A continuación puedes ver un ejemplo de cobrar $1 dólar con impuestos.
- amount: 112
- tax: 12
- amountWithTax: 100
Para cobrar $1 dólar sin impuestos, los valores serían los siguientes:
- amount: 100
- amountWithTax: 100
El botón de pago te entrega ciertos datos de respuesta para que tu puedas tramitar el resultado de la transacción y tomar acción de acuerdo al resultado:
- statusCode: Código de estado de la transacción. 2=Cancelado.03=Aprobada
- transactionStatus: Estado de la transacción.
Con El statusCode y el transactionStatus puedes mostrar a tu cliente si el pago fue aprobado o rechazado. El resto de parámetros para conciliación, número de transacción y de autorización te recomendamos les des gestión en tu URL de respuesta.
Con esta configuración, tu Express Checkout está listo y tus clientes pueden pagar. Solo te falta configurar tu Url de respuesta.
