MANUAL DE INTEGRACIÓN PAGOS EN EFECTIVO

Transcripción

1 MANUAL DE INTEGRACIÓN PAGOS EN EFECTIVO Nuestra API proporciona 3 métodos para implementar el proceso de pagos en efectivo en tu sitio web. Éstos se mencionan a continuación: Métodos 1. Realizar una orden/cargo Entorno: Stage/Prueba - Producción - Verbo HTTP: POST Campos de la petición: Campo Tipo Descripción branch_key String(100) Api key sucursal. NOTA: éste dato se envió en el momento del registro o en el user_key String(100) Api key usuario. NOTA: éste dato se envió en el momento del registro o en el order_id String(45) Tú identificador para la orden de compra. NOTA: debe ser único e irrepetible para cada orden product String(100) Descripción del producto o nombre del producto amount Double(8,2) Monto (MXP) a pagar. NOTA: Revisar montos máximos. Ver anexo 1 store_code String(30) Código de la tienda de conveniencia. NOTA: Ver anexo 1 customer String(100) Nombre del comprador String(100) E- mail del comprador

2 2. Consultar una orden/cargo Entorno: Stage/Prueba - Producción - Verbo HTTP: GET Campos de la petición: Campo Tipo Descripción branch_key String(100) Api key sucursal. NOTA: éste dato se envió en el momento del registro o en el user_key String(100) Api key usuario. NOTA: éste dato se envió en el momento del registro o en el reference String(45) Identificador enviado por PagoFácil al realizar una orden/cargo 3. Reporte de órdenes /cargos Entorno: Stage/Prueba - Produccion - Verbo HTTP: GET/POST Campos de la petición : Campo Tipo Descripción branch_key String(100) Api key sucursal. NOTA: éste dato se envió en el momento del registro o en el user_key String(100) Api key usuario. NOTA: éste dato se envió en el momento del registro o en el secret_key String(64) Clave privada. NOTA: debe solicitarla a soporte@pagofacil.net date_start String(19) Fecha inicial del reporte, formato AAAA- MM- DD HH:MM:SS date_end String(19) Fecha inicial del reporte, formato AAAA- MM- DD HH:MM:SS

3 ANEXO 1 Tiendas de conveniencia: Establecimiento Código Monto máximo OXXO OXXO 15, MXN Seven eleven SEVEN_ELEVEN 15, MXN Extra EXTRA 5, MXN Chedraui CHEDRAUI 5, MXN Farmacias Benavides FARMACIA_BENAVIDES 5, MXN Farmacias Esquivar FARMACIA_ESQUIVAR 5, MXN

4 Ejemplos en código Nota: todos los ejemplos apuntan al ambiente de pruebas/stage. Realizar un cargo/orden: Response JSON { "error" : "0", "message" : "", "charge" : { "reference" : "PFCPE3S3I32", "amount" : " ", "convenience_store" : "OXXO", "bank_account_number" : " ", "bank" : "BANCO DE PRUEBAS", "created_at" : " :03:29", "expiration_date" : " :03:30", "status" : "0"

5 PHP CURL $host = ; $params = array( branch_key => ba3b ebeebeed1327c14959a94a74be, user_key => ce4287a4093e4fca1928f2cde9bf041ee7de8292, order_id => tienda_pedro_001, product => camara fotografica de 15 mega pixeles, amount => , store_code => OXXO, customer => pedro perez, => pedro@pagofacil.net, ); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $host); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params)); $result = curl_exec($ch); curl_close($ch); $data = json_decode($result, true);

6 RUBY 1.7 require "net/http" require "uri" uri = URI.parse(" http = Net::HTTP.new(uri.host, uri.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net:: request.set_form_data({ "branch_key" => "ba3b ebeebeed1327c14959a94a74be", "user_key" => "ce4287a4093e4fca1928f2cde9bf041ee7de8292", "order_id" => "tienda_pedro_001", "product" => "camara fotografica de 15 mega pixeles", "amount" => " ", "store_code" => "OXXO", "customer" => "pedro perez", " " => "pedro@pagofacil.net" ) response = http.request(request) puts response.body

7 JAVA 1.7 package cash_payment_client; import java.io.bufferedreader; import java.io.dataoutputstream; import java.io.inputstreamreader; import java.net.url; import javax.net.ssl.httpsurlconnection; public class Cash_payment_client { public static void main(string[] args) { try { String url = " URL endpoint = new URL(url); HttpsURLConnection client = (HttpsURLConnection)endpoint.openConnection(); client.setrequestmethod("post"); String params = "branch_key=ba3b ebeebeed1327c14959a94a74be" + "&user_key=ce4287a4093e4fca1928f2cde9bf041ee7de8292" + "&order_id=tienda_pedro_001" + "&product=camara fotografica de 15 mega pixeles" + "&amount= " + "&store_code=oxxo" + "&customer=pedro perez" + "& =pedro@pagofacil.net"; client.setdooutput(true); DataOutputStream writer = new DataOutputStream(client.getOutputStream()); writer.writebytes(params); writer.flush(); writer.close();

8 BufferedReader in = new BufferedReader( new InputStreamReader(client.getInputStream()) ); String inputline; StringBuffer response = new StringBuffer(); while ((inputline = in.readline())!= null) { response.append(inputline); in.close(); System.out.println(response.toString()); catch (Exception exception) { System.out.println("EXCEPTION: " + exception.getmessage());

9 C# (.NET Framework 4) using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Net; using System.IO; namespace ConsoleApplication1 { class Program { static void Main(string[] args) { WebRequest request = WebRequest.Create( ); string param = "branch_key=ba3b ebeebeed1327c14959a94a74be" + "&user_key=ce4287a4093e4fca1928f2cde9bf041ee7de8292" + "&order_id=tienda_pedro_001" + "&product=camara fotografica de 15 mega pixeles" + "&amount= " + "&store_code=oxxo" + "&customer=pedro perez" + "& =pedro@pagofacil.net"; request.method = "POST"; request.contenttype = "application/x- www- form- urlencoded"; request.contentlength = param.length; byte[] paramslist = Encoding.UTF8.GetBytes(param); Stream writer = request.getrequeststream(); writer.write(paramslist, 0, paramslist.length); writer.close(); WebResponse response = request.getresponse(); string result = (new StreamReader(response.GetResponseStream())).ReadToEnd(); Console.WriteLine(result); response.close();

10 JQUERY $.ajax({ url : ' type : 'POST', crossdomain: true, datatype : 'json', data : { branch_key : 'ba3b ebeebeed1327c14959a94a74be', user_key : 'ce4287a4093e4fca1928f2cde9bf041ee7de8292', order_id : 'tienda_pedro_001', product : 'camara fotografica de 15 mega pixeles', amount : ' ', store_code : 'OXXO', customer : 'pedro perez', 'pedro@pagofacil.net', beforesend : function (request, settings) { alert('enviando...');, complete : function (response, status) { alert('completado');, error : function (request, status, error) { alert('error: ' + status + ' - ' + error);, success : function(data) { alert(json.stringify(data)); );