ETPay Mexico

Required parameters for the integration of the ALPS system with EtPay México for payment processing.

Default Banking Configuration

Name	Default value
Account Type	clabe
Default Bank	MEXICO PAYOUTS
Bank ID in ALPS	940

Request example

curl 'https://uat-api.alps.cl/v1/transactions/'
  --header 'Authorization: ALPS {TOKEN}'
  --header 'Content-Type: application/json'
  --data-raw '[{"order_id":"20250421005","credit_note":"20250421005","account_id":"019122219004301156","account_type":"clabe","vat_id":"019122219004301156","name":"JUAN PEREZ GARCIA","amount":1500.5,"subject":"PAGO POR SERVICIOS","bank_detail":"PAGO ALPS MEXICO","channel":"Transferencia","user_email":"[email protected]","phone_number":"+525512345678","bank":"940"}]'

import requests
import json

url = "https://uat-api.alps.cl/v1/transactions/"

payload = json.dumps([
  {
    "order_id": "20250421005",
    "credit_note": "20250421005",
    "account_id": "019122219004301156",
    "account_type": "clabe",
    "vat_id": "019122219004301156",
    "name": "JUAN PEREZ GARCIA",
    "amount": 1500.5,
    "subject": "PAGO POR SERVICIOS",
    "bank_detail": "PAGO ALPS MEXICO",
    "channel": "Transferencia",
    "user_email": "[email protected]",
    "phone_number": "+525512345678",
    "bank": "940"
  }
])

headers = {
  'Authorization': 'ALPS {TOKEN}',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

Fields description

Attribute	Mandatory	Data type	Description
`order_id`	`True`	String (255)	Unique order identifier
`credit_note`	`True`	String (255)	Credit note number
`account_id`	`True`	String (255)	Beneficiary's CLABE account number
`account_type`	`True`	String (255)	Always "clabe" for Mexico
`vat_id`	`True`	String (255)	Same value as account_id - field needed in data entry but not required by EtPay
`name`	`True`	String (255)	Beneficiary's full name
`amount`	`True`	Float	Amount to be transferred
`bank`	`True`	String (255)	Always "940" (MEXICO PAYOUTS)
`subject`	`False`	String (255)	Payment subject
`bank_detail`	`False`	String (255)	Additional bank details
`channel`	`False`	String (255)	Payment channel ("Transferencia")
`user_email`	`False`	String (255)	Notification email
`phone_number`	`False`	String (255)	Phone number

📘
Important Note Regarding 'vat_id'
The vat_id field must contain the same value as account_id. Although this field is required in the ALPS input structure, it is not used by ETPay when processing the payment. This duplication is only necessary to maintain compatibility with the ALPS data structure.