ChangeLogs
All notable changes to HashDT APIs and documentation are recorded here, in reverse chronological order.
October 30, 2026
Documentation ImprovedPowerUp Card Program — Cardholder Region Restrictions Documentation
Added the Cardholder Region Restrictions page, covering residence country and nationality-based proof-of-address (POA) requirements for card issuance. The Create Cardholder API reference now links to it.
Action required: Review the new page and make sure cardholders from Red-group nationalities have identity.proof_of_address, proof_of_address_issue_date, and proof_of_address_issuing_country saved before requesting a card.
October 28, 2026
ImprovedPowerUp Card Program — Create Cardholder API — KYC Verification Updates
Enhanced the Create Cardholder API to support the kyc_verification object for third-party KYC verification. This object is required when using a client-managed KYC provider and optional when using the platform's default KYC provider.
October 26, 2026
Breaking ChangePowerUp Card Program — Create Cardholder API — Mandatory Field Updates
Updated the Create Cardholder API request validation to require additional fields in the request body:
gender— Cardholder's gender (MALEorFEMALE).nationality— Cardholder's nationality as a 2-letter ISO 3166-1 country code.identity— Cardholder's identity details, including:type— Identity document type (ID_CARDorPASSPORT).number— Identity document number.front_file— Base64-encoded front-side image of the identity document. Maximum decoded file size: 2 MB (2,097,152 bytes).back_file— Base64-encoded back-side image of the identity document (required forID_CARD). Maximum decoded file size: 2 MB (2,097,152 bytes).proof_of_address— Base64-encoded proof-of-address (POA) document. Conditionally required for certain nationalities. Supported formats:PDF,PNG,JPG, andJPEG. Maximum decoded file size: 10 MB (10,485,760 bytes).proof_of_address_issue_date— Issue date of the POA document in ISO 8601 format (YYYY-MM-DD). The document must have been issued within the 12 months preceding submission. Required when POA is applicable.proof_of_address_issuing_country— 2-letter ISO 3166-1 country code of the country or region that issued the POA document. Required when POA is applicable.
Action required: Update existing integration requests to include all newly mandatory fields to avoid validation failures.
October 13, 2026
Breaking Change ImprovedPowerUp Card Program — Secure Iframe — token Now Required
The Secure Iframe URL now requires a Base64-encoded token as an additional path segment, after card_id and x_user_id. The token is the access token returned by the Obtain Access Token API. This applies to both sandbox and production environments.
The URL pattern is now:
{{baseUrl}}/cardSensetiveDetails/{{card_id}}/{{x_user_id}}/{{token}}?styles={{styleEncoding}}
Action required: Update your integration to obtain an access token from your backend and include it, Base64-encoded, in the URL path. Requests missing the token will fail. See the Secure Iframe Guide for the updated implementation.
Breaking Change
PowerUp Card Program — Secure Iframe — Style Selector Rename
Supported style selectors are now prefixed with .card- instead of .uq-card-. For example, .uq-card-container is now .card-container.
| Previous Selector | New Selector |
|---|---|
.uq-card-container | .card-container |
.uq-card-label | .card-label |
.uq-card-number | .card-number |
.uq-card-expiry | .card-expiry |
.uq-card-cvv | .card-cvv |
.uq-card-button | .card-button |
.uq-card-button:hover | .card-button:hover |
.uq-card-tooltip | .card-tooltip |
Action required: Update any existing styles objects to use the new selector names. Selectors that are not supported may not affect the rendered card details.
Breaking Change
PowerUp Card Program — Get All Cards — Mandatory Query Parameter Update
The Get All Cards API now requires cardholder_id as a mandatory query parameter.
Action required: Update your API requests to include the cardholder_id query parameter. Requests missing this parameter may be rejected.
October 9, 2026
Breaking ChangePowerUp Card Program — Get All Cardholders / Get Cardholder Details — Mandatory Header Updates
The Get All Cardholders and Get Cardholder Details APIs now require agent-code and subagent-code as mandatory header inputs.
Action required: Update your API requests to include both headers. Requests missing either header will be rejected.
September 21, 2026
DocumentationAdded an Interactive Demo for previewing the secure card details integration in the PowerUp Card Program.
September 17, 2026
DocumentationAdded the documentType and documentIdNumber fields to the Create Cardholder request body in Core Card Program documentation and clarified the conditional requirements for the KYC-related fields.
September 16, 2026
Breaking Change ImprovedPowerUp Card Program — Get All Cardholders / Get Cardholder Details — Address Field Fix
Address details are now correctly populated within individual.address. Previously, address information was only available at the top level of the response as postal_address, while individual.address was returned as null.
The top-level postal_address field is deprecated and will be removed in a future release — it is retained temporarily for backward compatibility.
Action required: Update your integration to read address details from individual.address instead of postal_address. A removal date will be announced separately.
Breaking Change
PowerUp Card Program — Secure Iframe — x_user_id Now Required
The Secure Iframe URL now requires a Base64-encoded x_user_id as an additional path segment, alongside the existing card_id.This applies to both sandbox and production environments. The styles parameter and its behavior are unchanged.
Action required: Update your integration to include a Base64-encoded x_user_id in the URL path. Requests missing this parameter will fail. See the Secure Iframe Guide for the updated implementation.
September 13, 2026
Breaking ChangeWebhook APIs — Endpoint Migration
All five Webhook API endpoints have moved to the new /hashdt/api/v1/notification/ path. Request parameters, request body, and response structures are unchanged.
| Method | Previous Endpoint | New Endpoint |
|---|---|---|
| GET | /internal/api/v1/notification/webhook/getallwebhooks | /hashdt/api/v1/notification/getallwebhooks |
| POST | /internal/api/v1/notification/webhook/api/subscribe | /hashdt/api/v1/notification/subscribe |
| POST | /internal/api/v1/notification/webhook/api/subscribedwebhook | /hashdt/api/v1/notification/subscribedwebhook |
| PATCH | /internal/api/v1/notification/webhook/api/subscribe | /hashdt/api/v1/notification/subscribe |
| DELETE | /internal/api/v1/notification/webhook/api/subscribe | /hashdt/api/v1/notification/subscribe |
Action required: The existing /internal/api/v1/notification/webhook/api endpoints will be deprecated effective November 1, 2026. Update your integration to the new endpoints before this date to avoid service disruption.
- Added Phone Number Validation Rules for country-specific length requirements to ease cardholder creation in PowerUp Card Program.
September 9, 2026
Breaking ChangePowerUp Card Program — Cardholder Age Validation
Updated the date_of_birth validation for Create Cardholder: cardholders must now be at least 18 and under 80 years old. Previously, there was no upper age limit.
Cardholders exactly 18 years old remain eligible. Cardholders 80 years or older are no longer eligible.
Action required: Update eligibility checks for cardholders aged 80 or above before September 17, 2026. Requests that do not meet the age requirement will be rejected after this date.
Improved
Create Card — limits Now Optional
The authorization_controls.transaction_limits.limits array in the Create Card API is now optional. Previously, this array was required on every request.
If provided, each entry in the limits array must still include both amount and interval — partial entries are not accepted.
Existing integrations that already provide limits are unaffected and continue to work as before.
August 30, 2026
NewPowerUp Banking Program
Introduced a unified banking solution for opening receiving accounts, managing beneficiaries, converting currencies, and sending cross-border payouts through supported payment rails.
- Added 18 new APIs covering account management, foreign exchange and conversion, beneficiary management, and cross-border payouts.
- Added a complete Postman Collection for PowerUp Banking APIs.
- Added Authentication support for obtaining bearer access tokens.
- Added Onboarding guidance for the HashDT-managed onboarding and verification process.
Documentation
- Added the Program Guide and Program Comparison pages to help developers choose between Core, PowerUp, and PowerUp Banking.
- Added the Go-Live Checklist to help partners confirm production readiness across all supported programs.
- Restructured API References into Issuing (Core Card Program, PowerUp Card Program) and Banking (PowerUp Banking Program), alongside the shared Webhook API.
August 10, 2026
NewPowerUp Card Program
Introduced a streamlined, recharge-first card program with simplified PIN and spend limit configuration.
- Added 14 new APIs covering Cardholder management, Card issuance, activation, recharge, and transactions. Wallet and KYC APIs are shared with the Core Card Program.
- Added Authentication support for obtaining bearer access tokens.
- Added a complete Postman Collection covering both Core and PowerUp Card Program APIs.
Documentation
- Added the Card Status Lifecycle guide, documenting supported statuses and valid transitions for both Core and PowerUp Card Programs.
- Added the Secure Iframe Guide, covering PCI-compliant rendering of sensitive card details (card number, expiry, CVV).
- Restructured API References into Core Card Program, PowerUp Card Program, and shared Webhook/KYC/Wallet sections.
- Added the Program Comparison table to help developers choose between Core and PowerUp.
June 20, 2026
Updated- Updated the Get Card Transactions response message to "Card Transaction History".
- Updated the Get Wallet History response message to "Wallet Transaction History".
April 10, 2026
Documentation- Added a Postman Collection for Core Card APIs to simplify API testing.
- Added the API Playground (Try It Out) for Core Card APIs, enabling in-browser API testing.
February 1, 2026
Initial Release- Initial release of HashDT APIs and documentation.
- Core Card Program launched — Cardholder, KYC, Wallet, Cards, Transfer, PIN, Spend Limit, and Transaction APIs.
- Webhook support for real-time event notifications.
- Sandbox environment and API keys available for testing.