| Field | Description | Validation |
|---|---|---|
| document_number | RUT (Rol Único Tributario) | Length >=8 <= 12, RegEx ^(\d{1,2}[.,\s]*\d{3}[.,\s]*\d{3}[.,\s]*-[0-9kK]|\d{7,8}-?[0-9kK])$, Must be valid RUT |
| Email address | Length >= 5 <= 50, RegEx ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$ | |
| bank_code | Bank identifier code | See Bank Identifier Codes below |
| Name | Code | Channel |
|---|---|---|
| Banco de Chile | banco_chile | Bank Transfer |
| Banco Estado | banco_estado | Bank Transfer |
| BCI | bci | Bank Transfer |
| Banco Falabella | falabella | Bank Transfer |
| Banco Itaú | itau | Bank Transfer |
| Banco Santander | santander | Bank Transfer |
| Banco Security | security | Bank Transfer |
| Scotiabank | scotiabank | Bank Transfer |
| Mach | mach | Wallet |
| Tapp | tapp | Wallet |
| Test Bank (Sandbox Only) | test_bank |
CLP has no minor currency units, supplied amounts must be an integer amount with no decimal places
Valid:
3724
193457345
Invalid:
3724.00
3724.50
Logos for primary banks can be displayed to enhance the user experience as per the PayPaga demonstration site.
Logos can be sourced from the Assets in the documentation Appendix
By default requests in the Sandbox environment are processed by a Provider simulator, to enable Provider Sandbox processing set DisablePartnerMock header to true.
This header only applies to the Sandbox environment.
Initiated transactions that are not completed, transition to an Expired state after 72 hours.
curl --location --request POST 'https://api.v2.stg.paypaga.com/payment' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
"transaction_id": "20251030-1529-4510-bc3c-6321213ee17f",
"payment_method_code": "bank_transfer",
"country_code": "CL",
"currency": "CLP",
"transaction_total": 123,
"merchant_transaction_reference": "d0d72900-4734-47c4-8fc7-c2ffea70244f",
"transaction_fields": [
{
"name": "document_number",
"value": "3880986-5"
},
{
"name": "email",
"value": "mail@mail.com"
},
{
"name": "bank_code",
"value": "banco_chile"
}
]
}'{
"transaction_id": "20251030-1529-4510-bc3c-6321213ee17f",
"transaction_payment_mode": "ASYNCHRONOUS",
"payment_method_reference": "20251030-1529-4510-bc3c-6321213ee17f",
"message": "Transaction Successfully",
"version": "0.1",
"next_steps_detail_instructions": [
{
"type": "external_link",
"key": "reference_url",
"label": "Presione aquí para completar su pago",
"description": "https://paypaga.com/session/3YGRrYc3PFEtUyPm2PFSjMjDXalnX0VcJJkO8ifR63YDinB8tGvgPkEQaVaHPkG1"
}
]
}