Release Details
Release Date: March 27th, 2025
Release Type
Informational – optional action from platforms
Summary
Background
Platforms can accompany their Zero Hash integration with a PSP integration. This is to allow customers to purchase crypto or stablecoins using a card or a popular digital wallet (ie, Apple Pay) - the company responsible for this part of the flow is the PSP.
The PSP is responsible for the processing of the fiat leg of the transaction, Zero Hash is responsible for the crypto or stablecoin side (unless of course you are using any of Zero Hash's fiat product offerings directly).
New Requirements
To fulfill regulator audits, Zero Hash must be able to associate a Zero Hash transaction to and associated PSP one. We will do this by leveraging the new Zero Hash object payment_processor. This has been added to the below endpoints:
and it contains two sub-fields:
| Field | Description | Validation |
|---|---|---|
name | The name of the PSP that processed the transaction | free-form |
id | The unique ID that can be tied back to the PSP transaction |
Example requests:
-- POST /liquidity/rfq
{
"participant_code":"CUST01",
"side": "buy",
"underlying": "USDC",
"quoted_currency": "USD",
"total": "500",
"payment_processor": {
"name": "checkout.com", -- the name of the PSP clearing the fiat leg of the trade
"id": "5cd07738b861c31e3bd61467BTC1Buy1568311644602" --this will be used by Zero Hash to reconcile with the PSP
}
}
-- POST /convert_withdraw/rfq
{
"participant_code":"CUST01",
"side": "buy",
"underlying": "USDC",
"quoted_currency": "USD",
"total": "500",
"withdrawal_address": "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
"payment_processor": {
"name": "checkout.com", -- the name of the PSP clearing the fiat leg of the trade
"id": "5cd07738b861c31e3bd61467BTC1Buy1568311644602" -- the unique ID that must be tied back to the PSPs transaction - this will be used by Zero Hash to reconcile with the PSP
}
}
Settlement Flow
There are 2 different types of settlement sessions:
- Net buy session: There is more
buyvolume thansell(therefore Zero Hash receive a settlement) - Net sell session: There is more
sellvolume thanbuy(therefore Zero Hash will disperse a settlement)
Net Buy
- Zero Hash will receive a settlement directly from the PSP
- The funds will be credited to the Platform's float account
Net Sell
- Platform can request a USD withdrawal on the client portal or via API to their respective bank
Action Required
n.a
Products Impacted
- Remittance
- On and Off Ramp
