PSP Integration - New Requirements

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 buy volume than sell (therefore Zero Hash receive a settlement)
Net sell session: There is more sell volume than buy (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