Changelog
Breaking changes are announced with at least 90 days notice (180 days for production-impacting). Non-breaking additions land as they ship.
See API versioning for the policy.
2026-11-03 β Change a cardholder's phone numberβ
Added
- PATCH /users/{userId}/personal-data (Wallet Gateway) now accepts phoneNumber, together with phoneVerification: proof that your application verified the new number with its own OTP. If the cardholder also has an account in another application, it answers 409 with code 7189. See Change the phone number.
2026-10-09 β Vouchers and receipts in Spanish and Englishβ
Added
- Payment vouchers and emailed receipts are generated in the customer's language (Spanish or English). See Hosted webview.
2026-10-08 β Update a cardholder's dataβ
Added
- PATCH /users/{userId}/personal-data (Wallet Gateway): updates the personal data of a cardholder of your application (first name, last name, birthdate, marital status, gender, address, neighborhood and place of birth). See Update a cardholder's data.
2026-10-05 β Find a cardholder by documentβ
Added
- GET /users/by-document (Wallet Gateway): returns the account and userId of a cardholder of your application from their DPI. See Find a cardholder by document.
2026-09-30 β Terminal payment webhooksβ
Added
- Payment webhooks: a signed (HMAC-SHA256)
POSTto your commerce's URL for every approved (terminal.payment.approved) or denied (terminal.payment.denied) terminal payment, retried for about 33 hours. POST /businesses/commerces/{commerceId}/webhooks,GET /businesses/commerces/{commerceId}/webhooks,GET /businesses/commerces/{commerceId}/webhooks/{webhookId},PATCH /businesses/commerces/{commerceId}/webhooks/{webhookId}andDELETE /businesses/commerces/{commerceId}/webhooks/{webhookId}(Wallet Gateway) β register, read, update, pause and delete a commerce's webhooks.- Error codes
7713β7717.
2026-04-18 β Developer portal launchβ
Added
- Public developer portal with ES + EN localization.
- Two interactive API references (Scalar): Wallet Gateway, Middleware.
- Error catalog covering all codes in the 7000β8099 range.
2026-03-15 β Middleware: bulk CSV chargesβ
Added
POST /api/v1/subscriptions/charges/upload-csvβ batch charge intake (up to 5,000 items per file).
2026-02-01 β Third-party card linkingβ
Added
POST /users/{userId}/linked-cards(Wallet Gateway) β link external cards (owner email + last 4 digits).
2025-11-20 β Terminal payments GAβ
Added
POST /terminal-paymentβ POS settlements.PATCH /terminal-payment/{id}β same-day void + post-settlement refund.
2025-06-01 β Public releaseβ
- Initial public GA of the Wallet Gateway API.