ID: 37 - Bank Transfer (MXN)

Channel: 37

Provider: Fintoc

Payment Method: Bank transfer (SPEI)


Available Currencies

NameCodeCountry
Mexican pesoMXNMexico

How it works

The shopper pays with a SPEI bank transfer to a CLABE generated for the transaction. You can use this channel in two ways:

ModeWhat you receiveWho shows the CLABE to the shopper
Checkout (default)The ALPS checkout URLThe ALPS checkout
Direct integrationA JSON object with the CLABE detailsYour own interface

In both modes the final status of the payment is sent to your notification URL (see Notifications).

Request example

curl -X "POST" "https://uat-payments.alps.cl/justpay/check-out/SecurePayment" \
     -H 'Content-Type: application/x-www-form-urlencoded; charset=utf-8' \
     --data-urlencode "public_key={YOUR_PUBLIC_KEY}" \
     --data-urlencode "time=2026-11-05T13:00:00" \
     --data-urlencode "channel=37" \
     --data-urlencode "amount=250.00" \
     --data-urlencode "currency=MXN" \
     --data-urlencode "trans_id=04b73345" \
     --data-urlencode "time_expired=360" \
     --data-urlencode "url_ok=https://example.com/ok" \
     --data-urlencode "url_error=https://example.com/error" \
     --data-urlencode "signature={YOUR_SIGNATURE}" \
     --data-urlencode "shopper_information={\"name_shopper\": \"Jon\",\"last_name_Shopper\": \"Snow\", \"type_doc_identi\": \"PAS\", \"Num_doc_identi\": \"G1234567\", \"email\": \"[email protected]\", \"country_code\": \"+52\", \"Phone\": \"5512345678\", \"country\": \"MEX\"}"
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL            => 'https://uat-payments.alps.cl/justpay/check-out/SecurePayment',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_TIMEOUT        => 30,
  CURLOPT_CUSTOMREQUEST  => 'POST',
  CURLOPT_HTTPHEADER     => ['Content-Type: application/x-www-form-urlencoded; charset=utf-8'],
  CURLOPT_POSTFIELDS     => http_build_query([
    'public_key'          => '{YOUR_PUBLIC_KEY}',
    'time'                => '2026-11-05T13:00:00',
    'channel'             => 37,
    'amount'              => '250.00',
    'currency'            => 'MXN',
    'trans_id'            => '04b73345',
    'time_expired'        => 360,
    'url_ok'              => 'https://example.com/ok',
    'url_error'           => 'https://example.com/error',
    'signature'           => '{YOUR_SIGNATURE}',
    'shopper_information' => json_encode([
      'name_shopper'      => 'Jon',
      'last_name_Shopper' => 'Snow',
      'type_doc_identi'   => 'PAS',
      'Num_doc_identi'    => 'G1234567',
      'email'             => '[email protected]',
      'country_code'      => '+52',
      'Phone'             => '5512345678',
      'country'           => 'MEX',
    ]),
  ]),
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;
import json
import requests

response = requests.post(
    url="https://uat-payments.alps.cl/justpay/check-out/SecurePayment",
    headers={"Content-Type": "application/x-www-form-urlencoded; charset=utf-8"},
    data={
        "public_key": "{YOUR_PUBLIC_KEY}",
        "time": "2026-11-05T13:00:00",
        "channel": "37",
        "amount": "250.00",
        "currency": "MXN",
        "trans_id": "04b73345",
        "time_expired": "360",
        "url_ok": "https://example.com/ok",
        "url_error": "https://example.com/error",
        "signature": "{YOUR_SIGNATURE}",
        "shopper_information": json.dumps({
            "name_shopper": "Jon",
            "last_name_Shopper": "Snow",
            "type_doc_identi": "PAS",
            "Num_doc_identi": "G1234567",
            "email": "[email protected]",
            "country_code": "+52",
            "Phone": "5512345678",
            "country": "MEX",
        }),
    },
)

print(response.status_code, response.text)
const qs = require("querystring");
const https = require("https");

const body = qs.stringify({
  public_key: "{YOUR_PUBLIC_KEY}",
  time: "2026-11-05T13:00:00",
  channel: "37",
  amount: "250.00",
  currency: "MXN",
  trans_id: "04b73345",
  time_expired: "360",
  url_ok: "https://example.com/ok",
  url_error: "https://example.com/error",
  signature: "{YOUR_SIGNATURE}",
  shopper_information: JSON.stringify({
    name_shopper: "Jon",
    last_name_Shopper: "Snow",
    type_doc_identi: "PAS",
    Num_doc_identi: "G1234567",
    email: "[email protected]",
    country_code: "+52",
    Phone: "5512345678",
    country: "MEX"
  })
});

const req = https.request({
  method: "POST",
  hostname: "uat-payments.alps.cl",
  path: "/justpay/check-out/SecurePayment",
  headers: { "Content-Type": "application/x-www-form-urlencoded; charset=utf-8" }
}, (res) => {
  const chunks = [];
  res.on("data", (chunk) => chunks.push(chunk));
  res.on("end", () => console.log(res.statusCode, Buffer.concat(chunks).toString()));
});

req.write(body);
req.end();

The response is the ALPS checkout URL as plain text. Redirect the shopper to it.

Mandatory Data

AttributeMandatoryData typeDescription
public_keyTrueString (255)Public key, unique value that identifies the commerce
timeTrueDatetimeRequest date time
channelTrueIntegerPayment channel (37)
amountTrueDoubleThe amount of the transaction. Use 2 decimals.
currencyTrueString (3)Transaction currency code (MXN)
trans_idTrueString (255)Transaction id
time_expiredTrueString (255)Time in minutes to expire the transaction. Minimum suggested: 120 minutes
url_okTrueString (255)URL where the shopper will be redirected if the payment was successful (must be HTTPS)
url_errorTrueString (255)URL where the shopper will be redirected if the payment failed (must be HTTPS)
signatureTrueString (255)Signature hash256: Review signature calculation
shopper_informationTrueJSON StringJSON String Data: Review JSON index & format
direct_integrationFalseIntegerSend 1 to receive the CLABE details instead of the checkout URL. See Direct integration

shopper_information JSON format

📘

Field shopper_information must be sent in string format (JSON encode).

'{"name_shopper": "Jon","last_name_Shopper": "Snow","type_doc_identi": "PAS","Num_doc_identi": "G1234567","email": "[email protected]","country_code": "+52","Phone": "5512345678","country": "MEX"}'

The shopper_information field is a column corresponding to a json with the next keys:

ParameterMandatoryData TypeDescription
name_shopperTrueString (255)Shopper's name
last_name_ShopperTrueString (255)Shopper's last name
type_doc_identiTrueString (255)Identification document [CURP, RFC, INE, PAS]
Num_doc_identiTrueString (255)Identification document number, valid for the document type
emailTrueString (255)Shopper's e-mail
country_codeTrueString (10)Country's phone code (+52)
PhoneTrueString (20)Shopper's phone number. Must be a valid Mexican phone number
countryTrueString (3)Country ISO code [MEX]

The same fields are required in checkout mode and in direct integration.


Direct integration

With direct integration the shopper does not go through the ALPS checkout. You receive a JSON object with the CLABE, the amount and the expiration, and you show them to the shopper in your own interface.

Additional fields for direct integration

AttributeMandatoryData typeDescription
direct_integrationTrueIntegerSend 1 for direct integration

All the fields in Mandatory Data and shopper_information are still required. Add direct_integration=1 to any of the request examples:

curl -X "POST" "https://uat-payments.alps.cl/justpay/check-out/SecurePayment" \
     -H 'Content-Type: application/x-www-form-urlencoded; charset=utf-8' \
     --data-urlencode "public_key={YOUR_PUBLIC_KEY}" \
     --data-urlencode "time=2026-11-05T13:00:00" \
     --data-urlencode "channel=37" \
     --data-urlencode "amount=250.00" \
     --data-urlencode "currency=MXN" \
     --data-urlencode "trans_id=04b73345" \
     --data-urlencode "time_expired=360" \
     --data-urlencode "url_ok=https://example.com/ok" \
     --data-urlencode "url_error=https://example.com/error" \
     --data-urlencode "signature={YOUR_SIGNATURE}" \
     --data-urlencode "shopper_information={\"name_shopper\": \"Jon\",\"last_name_Shopper\": \"Snow\", \"type_doc_identi\": \"PAS\", \"Num_doc_identi\": \"G1234567\", \"email\": \"[email protected]\", \"country_code\": \"+52\", \"Phone\": \"5512345678\", \"country\": \"MEX\"}" \
     --data-urlencode "direct_integration=1"

Response

HTTP 200 with a JSON object:

{
  "operation_id": 184203,
  "clabe_number": "646180111800000001",
  "amount": "250.00",
  "currency": "MXN",
  "expires_at": "2026-11-05T19:00:00Z"
}
AttributeData typeDescription
operation_idIntegerALPS operation identifier
clabe_numberString18-digit CLABE the shopper must transfer to. It is generated for this transaction only
amountStringAmount the shopper must transfer, with 2 decimals
currencyStringCurrency code (MXN)
expires_atStringDate and time until the shopper can pay, ISO 8601 in UTC. Calculated from time_expired
📘

If the response is a plain-text URL instead of a JSON object, the transaction could not be served by direct integration. Redirect the shopper to that URL to complete the payment in the ALPS checkout.

Recommendations

  • Show the shopper the clabe_number, the exact amount and the expires_at deadline, converted to the shopper's time zone.
  • Let the shopper copy the CLABE with one click. Typing 18 digits by hand causes errors.
  • Use the CLABE only for this transaction. Create a new transaction for every payment.
  • Wait for the notification to your notification URL to confirm the payment. Do not mark an order as paid because the shopper says they transferred.
  • Set time_expired to the time a shopper realistically needs to open the banking app and transfer. Minimum suggested: 120 minutes.
⚠️

Transfers that are returned to the shopper

  • A transfer for an amount different from amount is returned to the shopper. The transaction is not marked as paid.
  • A transfer received for a transaction that is already paid, rejected or expired is returned to the shopper.

Notifications

The final status is sent to your notification URLs when Fintoc reports the transfer.

Fintoc statusNotification sent toContent
succeededSuccess notification URLStandard ALPS success notification
failed, rejectedRejection notification URLStatus and message reported by Fintoc
expiredRejection notification URLStatus and message reported by Fintoc

Transfers returned because of a different amount do not generate a notification. The transaction stays pending until it receives a valid transfer or expires.


Errors

Request errors are returned in the response body with these fields:

{
  "error": {
    "code": "SHOPPER_INVALID_DOCUMENT_TYPE",
    "message": "Invalid document type. Accepted values are: CURP, RFC, INE, PAS"
  }
}
CodeMessage
INVALID_CHANNELInvalid channel - {channel}
INVALID_AMOUNTAmount must be a valid number - {amount}
NEGATIVE_AMOUNTAmount must be greater than zero - {amount}
MAX_AMOUNT_LIMITAmount exceeds the maximum allowed (...) - {amount}
INVALID_CURRENCYInvalid currency. {currency}
INVALID_CURRENCY_CHANNELCurrency code not allowed for this channel - {currency}
SHOPPER_FIELD_REQUIREDShopper's information should have the following fields [...] - {shopper_information}
SHOPPER_COUNTRY_NOTALLOWEDCountry not allowed for this channel - {shopper_information.country}
INVALID_PHONE_NUMBERInvalid phone number - {shopper_information.Phone}
SHOPPER_INVALID_DOCUMENT_TYPEInvalid document type. Accepted values are: CURP, RFC, INE, PAS
SHOPPER_INVALID_DOCUMENT_NUMBERInvalid identity number format. - {shopper_information.Num_doc_identi}
CREATION_ERRORError creating payment operation