Immediate notification URL
The payout platform will automatically notify to the merchant site the "approved by bank" and "rejected by bank" transactions. This communication will be made via POST. To process payout notifications the merchant must create a page in their site that analyze the POST data received and activate the update in their database.
The merchant will have to provide ALPS with one (1) IPN notification url.
The merchant site must response a http code 200 or 203 in order to let us know that they have received the notification; if the request return a distinct code than 200 or 203, the notification will be marked as failed. The content of the response could be whatever the merchant want to send for their logs.
In order to test the notification, a Url to notify must be configured with ALPS integration team.
Output Data:
| Parameter | Description | Data Type | Example |
|---|---|---|---|
id | ID notification, assigned by the system. | Integer | 24 |
payroll | ID payout, assigned by the system. | Integer | 564 |
order_id | Payment order identification or credit note. | String (255) | 23454534456 |
credit_note | Internal code for customer use, it must be a unique code. | String (255) | 23454534456 |
account_id | Account number. | String (255) | 2862345 |
account_type | Account type. In Chile there are 4 types of accounts (Savings, Vista, current and Ruth) and in Peru (Savings Account and Current Account). | String (255) | rut |
vat_id | National identification document number , Passport number, PTP number. | String (255) | 1111111 |
vat_id_type | National identification document. In Chile RUT / RUN and in Peru DNI, CE, PASSPORT, PTP. | String (255) | rut |
name | Beneficiary Name. | String (255) | DOE JOHN |
amount | Amount to transfer. | Integer | 124000.0 |
subject | Free use. Example: He don't want / can't travel. | String (255) | Refund |
bank_detail | Free use. Example: Refund Company. | String (255) | Refund |
channel | Free use. Example: (refund e-commercer; Payment to providers; Transfer) | String (255) | Transfer |
user_email | Email to notify withdrawal. | String (255) | [email protected] |
phone_number | Phone to notify transfer. | String (255) | +5x000000000 |
transfer_status | Withdrawal Status. For more information, see the payout status list | Integer | 5 |
transfer_status_description | Description of the status. | String (255) | approved by bank |
currency | Currency ID. For more information, see the currency list | Integer | 3 |
currency_code | Currency Code. | String (255) | CLP |
bank_id | id Bank where the withdrawal will be made. For more information, see the list of banks. | Integer | 49 |
bank_name | Bank where the withdrawal will be made. | String (255) | Banco de Chile |
bank_reference | Bank Reference, automatically assigned by the System. | String (255) | TRANSFER-124000-CLP-BANCO-CHILE-63467 |
created_at | Notification Creation Date. | String (255) | 18-03-2025 10:23:57 |
updated_at | Notification Update Date. | String (255) | 18-03-2025 18:04:28 |
JSON Response data example:
{
"id": 24,
"payroll": 564,
"order_id": "23454534456",
"credit_note": "23454534456",
"account_id": "2862345",
"account_type": "rut",
"vat_id": "1111111",
"vat_id_type": "rut",
"name": "DOE JOHN",
"amount": 124000.0,
"subject": "DEVOLUCION ALPS",
"bank_detail": "DEVOLUCION ALPS",
"channel": "Transferencia",
"user_email": "[email protected]",
"phone_number": "+5x000000000",
"transfer_status": 5,
"transfer_status_description": "approved by bank",
"currency": 3,
"currency_code": "CLP",
"bank_id": 49,
"bank_name": "Banco de Chile",
"bank_reference": "TRANSFER-124000-CLP-BANCO-CHILE-63467",
"created_at": "18-03-2025 10:23:57",
"updated_at": "18-03-2025 18:04:28"
}