Channel: 37
Provider: Fintoc
Payment Method: Bank transfer (SPEI)
Available Currencies
| Name | Code | Country |
|---|---|---|
| Mexican peso | MXN | Mexico |
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:
| Mode | What you receive | Who shows the CLABE to the shopper |
|---|---|---|
| Checkout (default) | The ALPS checkout URL | The ALPS checkout |
| Direct integration | A JSON object with the CLABE details | Your 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
| Attribute | Mandatory | Data type | Description |
|---|---|---|---|
public_key | True | String (255) | Public key, unique value that identifies the commerce |
time | True | Datetime | Request date time |
channel | True | Integer | Payment channel (37) |
amount | True | Double | The amount of the transaction. Use 2 decimals. |
currency | True | String (3) | Transaction currency code (MXN) |
trans_id | True | String (255) | Transaction id |
time_expired | True | String (255) | Time in minutes to expire the transaction. Minimum suggested: 120 minutes |
url_ok | True | String (255) | URL where the shopper will be redirected if the payment was successful (must be HTTPS) |
url_error | True | String (255) | URL where the shopper will be redirected if the payment failed (must be HTTPS) |
signature | True | String (255) | Signature hash256: Review signature calculation |
shopper_information | True | JSON String | JSON String Data: Review JSON index & format |
direct_integration | False | Integer | Send 1 to receive the CLABE details instead of the checkout URL. See Direct integration |
shopper_information JSON format
shopper_information JSON format'{"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:
| Parameter | Mandatory | Data Type | Description |
|---|---|---|---|
name_shopper | True | String (255) | Shopper's name |
last_name_Shopper | True | String (255) | Shopper's last name |
type_doc_identi | True | String (255) | Identification document [CURP, RFC, INE, PAS] |
Num_doc_identi | True | String (255) | Identification document number, valid for the document type |
email | True | String (255) | Shopper's e-mail |
country_code | True | String (10) | Country's phone code (+52) |
Phone | True | String (20) | Shopper's phone number. Must be a valid Mexican phone number |
country | True | String (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
| Attribute | Mandatory | Data type | Description |
|---|---|---|---|
direct_integration | True | Integer | Send 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"
}| Attribute | Data type | Description |
|---|---|---|
operation_id | Integer | ALPS operation identifier |
clabe_number | String | 18-digit CLABE the shopper must transfer to. It is generated for this transaction only |
amount | String | Amount the shopper must transfer, with 2 decimals |
currency | String | Currency code (MXN) |
expires_at | String | Date 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 exactamountand theexpires_atdeadline, 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_expiredto 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
amountis 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 status | Notification sent to | Content |
|---|---|---|
succeeded | Success notification URL | Standard ALPS success notification |
failed, rejected | Rejection notification URL | Status and message reported by Fintoc |
expired | Rejection notification URL | Status 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"
}
}| Code | Message |
|---|---|
INVALID_CHANNEL | Invalid channel - {channel} |
INVALID_AMOUNT | Amount must be a valid number - {amount} |
NEGATIVE_AMOUNT | Amount must be greater than zero - {amount} |
MAX_AMOUNT_LIMIT | Amount exceeds the maximum allowed (...) - {amount} |
INVALID_CURRENCY | Invalid currency. {currency} |
INVALID_CURRENCY_CHANNEL | Currency code not allowed for this channel - {currency} |
SHOPPER_FIELD_REQUIRED | Shopper's information should have the following fields [...] - {shopper_information} |
SHOPPER_COUNTRY_NOTALLOWED | Country not allowed for this channel - {shopper_information.country} |
INVALID_PHONE_NUMBER | Invalid phone number - {shopper_information.Phone} |
SHOPPER_INVALID_DOCUMENT_TYPE | Invalid document type. Accepted values are: CURP, RFC, INE, PAS |
SHOPPER_INVALID_DOCUMENT_NUMBER | Invalid identity number format. - {shopper_information.Num_doc_identi} |
CREATION_ERROR | Error creating payment operation |
