Mexico

Bank Transfer Reference Payment

Bank Transfer Reference Payment allows the user to pay directly from their digital banking with a custom code to identify properly each operation. In order to get the reference number (ticket.barcode) our API will return to the final user and should follow these steps:

  1. Go to your Bank website or API

  2. Log into your digital banking

  3. Go to the "Payment Service" menu

  4. Enter the reference number and pay

The payment is processed and notified same day

POST https://api.stage.localpayment.com /api/payin

Headers

Request Body

To make a referenced payment, you must use the ticket.barcode that comes in the response.

"ticket": {

"barcode": "1250270000037"

}

Examples: Bank Transfer payin reference payment response

{
    "transactionType": "PayIn",
    "externalId": "17165612323",
    "internalId": "f6e84faf-c772-494b-8ff4-a97db55911eb",
    "paymentMethod": {
        "type": "BankTransfer",
        "code": "1693",
        "flow": "DIRECT"
    },
    "country": "MEX",
    "currency": "MXN",
    "amount": 105.0,
    "accountNumber": "484.484.00000011",
    "confirmed": {
        "currency": "MXN",
        "amount": 105.0,
        "fxQuote": 1.0
    },
    "payment": {
        "currency": "MXN",
        "fxQuote": 1.0,
        "financingFee": 0.0,
        "amount": 105.0
    },
    "localTaxes": [],
    "withHoldings": [],
    "fees": {
        "description": "Fee",
        "currency": "MXN",
        "fxSource": 16.69487,
        "fxQuote": 1.0,
        "amount": 1.52,
        "account": "484.484.00000011"
    },
    "status": {
        "code": "100",
        "description": "INPROGRESS",
        "detail": "The payin is pending the confirmation"
    },
    "ticket": {
        "image": "https://api.stage.localpayment.com/api/images/Code128/1250270000060",
        "barcode": "1250270000060",
        "expirationDate": "2024-05-25T21:00:16.3288242",
        "paymentInstructions": "<ol><li>Saldo</li><li>Pagar Servicio</li><li>Nuevo Servicio</li><li>Ingresar <b>CIE1420712</b> y seleccionar <b>Red Efectiva</b><br></li><li>Capturar REFERENCIA e Importe<br></li></ol><i>(Tiempo en que se refleja la operación: 30 minutos a 1 hora)</i><br>"
    },
    "merchant": {
        "type": "INDIVIDUAL",
        "name": "Obi Wan",
        "lastname": "Kenobi",
        "document": {
            "type": "DNI",
            "id": "12345678"
        },
        "email": "obiwankenobi@starwars.com",
        "phone": {
            "countryCode": "54",
            "areaCode": "11",
            "number": "98789632"
        },
        "address": {
            "street": "Charruas",
            "number": "938",
            "city": "Hurlingham",
            "state": "state",
            "country": "Argentina",
            "zipCode": "1688",
            "comment": "portero 801"
        },
        "birthdate": "2000-01-01",
        "nationality": "Argentinian",
        "userReference": "abc123"
    },
    "payer": {
        "type": "INDIVIDUAL",
        "name": "Fernando",
        "lastname": "Gomez",
        "document": {
            "type": "",
            "id": ""
        },
        "email": "paycash-middleware@localpayment.com",
        "phone": {
            "countryCode": "1",
            "areaCode": "11",
            "number": "98789632"
        },
        "address": {
            "street": "Siempre viva",
            "number": "1234",
            "city": "Temperley",
            "state": "state",
            "country": "Argentina",
            "zipCode": "1686",
            "comment": "timbre roto, llamar"
        },
        "birthdate": "01/01/1990",
        "nationality": "Argentino",
        "userReference": "identificador del pagador"
    },
    "intermediaries": [
        {
            "type": "INDIVIDUAL",
            "name": "Fernando",
            "lastname": "Gomez",
            "document": {
                "type": "DNI",
                "id": "37993830"
            },
            "email": "n.cabral@gmail.com",
            "phone": {
                "countryCode": "1",
                "areaCode": "11",
                "number": "98789632"
            },
            "address": {
                "street": "Siempre viva",
                "number": "1234",
                "city": "Temperley",
                "state": "state",
                "country": "Argentina",
                "zipCode": "1686",
                "comment": "timbre roto, llamar"
            },
            "birthdate": "01/01/1990",
            "nationality": "Argentino"
        }
    ],
    "date": {
        "creationDate": "2024-05-24T21:00:15.94+00:00",
        "processedDate": "2024-05-24T21:00:31.1906072",
        "expirationDate": "2024-05-25T21:00:16.3288242"
    },
    "paymentInstructions": "<ol><li>Saldo</li><li>Pagar Servicio</li><li>Nuevo Servicio</li><li>Ingresar <b>CIE1420712</b> y seleccionar <b>Red Efectiva</b><br></li><li>Capturar REFERENCIA e Importe<br></li></ol><i>(Tiempo en que se refleja la operación: 30 minutos a 1 hora)</i><br>",
    "errors": []
}

Examples: Bank Transfer payin payment reference request

{
	"paymentMethod": {
		"type": "BankTransfer",
		"code": "1693", 
		"flow": "DIRECT"
	},
	"externalId": "17165612323",
	"country": "MEX",
	"currency": "MXN",
	"amount": 105.00,
	"accountNumber": "484.484.00000011",
	"conceptCode": "0001",
	"comment": "Prueba PayCash",
    "merchant": {
        "type": "INDIVIDUAL",
        "name": "Obi Wan",
        "lastname": "Kenobi",
        "document": {
            "type": "DNI",
            "id": "12345678"
        },
        "userReference": "abc123",
        "email": "obiwankenobi@starwars.com",
        "phone": {
            "countryCode": "54",
            "areaCode": "11",
            "number": "98789632"
        },
        "birthdate": "2000-01-01",
        "nationality": "Argentinian",
        "address": {
			"street": "Charruas",
			"number": "938",
			"city": "Hurlingham",
			"state": "state",
			"country": "Argentina",
			"zipCode": "1688",
			"comment": "portero 801"
		}
    },
	"payer": {
		"type": "INDIVIDUAL",
		"name": "Fernando",
		"lastname": "Gomez",
		"document": {
            "id": "",
            "type": ""
        },
		"email": "paycash-middleware@localpayment.com",
		"phone": {
			"countryCode": "1",
			"areaCode": "11",
			"number": "98789632"
		},
		"birthdate": "01/01/1990",
		"nationality": "Argentino",
		"address": {
			"street": "Siempre viva",
			"number": "1234",
			"city": "Temperley",
			"state": "state",
			"country": "Argentina",
			"zipCode": "1686",
			"comment": "timbre roto, llamar"
		},
		"userReference": "identificador del pagador"
	},
    "bank":{
        "name":"Account holder name",
        "code":"014",
        "branch":{
            "code":"",
            "name":""
        },
        "account":{
            "type":"s",
            "number":"217309"
        },
    },
	"intermediaries": [{
		"type": "INDIVIDUAL",
		"name": "Fernando",
		"lastname": "Gomez",
		"document": {
			"id": "37993830",
			"type": "DNI"
		},
		"email": "n.cabral@gmail.com",
		"phone": {
			"countryCode": "1",
			"areaCode": "11",
			"number": "98789632"
		},
		"birthdate": "01/01/1990",
		"nationality": "Argentino",
		"address": {
			"street": "Siempre viva",
			"number": "1234",
			"city": "Temperley",
			"state": "state",
			"country": "Argentina",
			"zipCode": "1686",
			"comment": "timbre roto, llamar"
		},
	}],
	"device": {
		"id": "Android 9",
		"ip": "127.111.142",
		"browser": "Google Chrome"
	},
	"metaData": {
		"algoDelCliente": "informacion adicional del cliente"
	}
}

Example Ticket Reference Payment

The number you must enter in your hombanking is the one that appears below the barcode

Check the Payin Status Codes

Last updated