Zynk
Getting StartedProduct GuidesAPI ReferenceFAQ'sRecipes
Getting StartedProduct GuidesAPI ReferenceFAQ'sRecipes
  1. Archive
  • Transformer - Cross border transfer
    • Transformer: Entity
      • Create Entity
      • Entities
      • Entity By ID
      • Entity By Email
      • KYC Status
      • KYC Requirements
      • Submit KYC/KYB
      • Get KYC Documents
    • Transformer: Accounts
      • External Accounts
        • Generate Plaid Link Token
        • Update Plaid Link Token
        • Get External Account Payload Requirements
        • Add External Account
        • Enable External Account
        • Disable External Account
        • Delete External Account
        • Get External Account by ID
        • Get External Accounts
      • Funding Accounts
        • Create Funding Account
        • Activate Funding Account
        • Deactivate Funding Account
        • Funding Account by ID
        • All Funding Accounts
      • Entity Accounts (Deprecated)
        • Add Entity Account
        • Remove Entity Account
        • Get Entity Account
        • Get Entity Accounts
    • Transformer: Transfers
      • Simulate
      • Transfer
      • All transfers for partner
      • Transfer by execution ID
    • Transformer: Utility
      • Partner Payments Account Balance
      • Partner Payments Deposit
      • Get Jurisdictions
    • Webhooks
      • Get Webhook Events History
      • Registered Webhook URL
      • Register or Update Webhook URL
  • Transporter - Automated Liquidity Manager
    • ALM Market
      • Create Reserve Quote
      • Accept Reserve Frame
      • Get Active Reserves
      • Get All Reserves
    • Transaction Details by ID, Partner Transaction ID, or Transaction Hash
      GET
    • Transaction Details
      GET
    • Transaction Details by ID
      GET
    • Partner Details
      GET
    • Initiate Transaction
      POST
    • Replenish Fee Quote
      POST
    • Quote Fulfilled
      POST
    • Replenish Initiate
      POST
    • Replenish Batch Transaction
      POST
    • Replenish Fee Quote Batch
      POST
  • Teleport - Pay-In Accounts
    • Create Teleport Route
      POST
    • Update Teleport Destination
      POST
    • Toggle Teleport Status
      POST
    • Teleport Details
      GET
    • Teleport Routes by Entity
      GET
  • Continuum - Wallet Infrastructure
    • Authentication
      • Register primary authentication
    • Wallet Management
      • Prepare wallet creation challenge (Step 1)
      • Submit wallet creation activity (Step 2)
    • Account Management
      • Prepare account creation challenge (Step 1)
      • Submit account creation activity (Step 2)
    • Passkey Management
      • Prepare passkey registration (Step 1)
      • Submit passkey registration (Step 2)
      • Get passkey authenticators
      • Prepare passkey deletion (Step 1)
      • Submit passkey deletion (Step 2)
    • Wallet Information
      • Get wallet details
      • Get wallet balances
      • Get transactions for address
    • Sessions
      • Initiate OTP delivery
      • Start authentication session
  • Archive
    • KYC Documents
      GET
    • Prepaid KYC Balance
      GET
    • Prepaid KYC Deposit
      POST
  1. Archive

Prepaid KYC Deposit

Deprecated
POST
/api/v1/transformer/utility/prepaid/kyc/deposit
(Soon to be deprecated) Please checkout the APIs in the Partner Payments section instead.
The Prepaid KYC Deposit API allows partners to notify the system about funds deposited into their prepaid KYC account. Once verified, these funds are credited to the partner's balance for future KYC operations.
Signature Generation
The base64Signature field is essential for verifying that you are the rightful owner of the transaction. To generate this signature:
1.
Use the same private key/wallet that initiated the blockchain transaction
2.
Sign the transactionHash value as the message
3.
Encode the resulting signature in Base64 format
You can generate this signature using a publicly available, open-source tool: Solana Message Signer
This security measure prevents unauthorized users from claiming deposits made by others and ensures that only legitimate deposit claims are processed.
Complete Deposit Process
1.
Get Deposit Instructions
GET /transformer/utility/prepaid/kyc/balance
Note the network, currency, tokenAddress, and toWalletAddress from the response.
2.
Make the Deposit
Send funds to the specified toWalletAddress using the correct blockchain network
Use the correct token as specified in the deposit instructions
Save the transaction hash from this transaction
3.
Generate Signature
Use the same wallet/private key that initiated the transaction
Sign the transaction hash as a message
Encode the signature in Base64 format
You can use the publicly available Solana Message Signer tool for this step
4.
Notify About the Deposit
POST /transformer/utility/prepaid/kyc/deposit
Include both the transaction hash and the Base64 signature in the request body
5.
Verify the Deposit
Check the response to confirm the deposit was successful
You can also call the Prepaid KYC Balance API again to verify your updated balance
Usage Notes
Each transaction hash can only be used for a single deposit. Attempting to reuse a transaction hash will result in a 400 Bad Request error.
The deposit amount credited is determined based on the actual amount transferred in the blockchain transaction.
After a successful deposit, your prepaid balance can be used for KYC submissions without including a transaction hash in each submission.
The signature verification ensures that only the rightful owner of a transaction can claim the deposit, preventing fraudulent claims.

Request

Body Params application/json

Examples

Responses

🟢200OK
application/json
Deposit notification processed successfully
Body

🟠400Bad Request
🟠401Unauthorized
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v1/transformer/utility/prepaid/kyc/deposit' \
--header 'Content-Type: application/json' \
--data-raw '{
    "transactionHash": "57hFL4uiCw7mEu8wrFxVJeJaASwT3ksuWxbPt2FvRgYpMc29szZlkqQGwrRGEfFQwvaYBrvtPEdAwt tnKCgN1GD",
    "base64Signature": "KxdG5LGmDW3r5pNHzzjBTW56LGJQ4zfP+JKqdjJ77F5EVrL/Qx13cVPY0xM6R3B+2V8zLm6dNwrtjXeDB4gEBQ=="
}'
Response Response Example
200 - Example 1
{
    "success": true,
    "data": {
        "mintTransactionHash": "63pfWda9vy1sbQ8XKhUbgKuC4KUz7K9oVWXqnp5XHyNf2zgkmTeSrxImNJSQsiGtTRYPDFcNGkNydjv7u1l4V",
        "mintAddress": "HVD2u7fRbeQem9dO9AfS25FkidtjLiKdJTcr5GmahSAQ",
        "message": "Deposit successful"
    }
}
Modified at 2025-07-23 14:13:50
Previous
Prepaid KYC Balance
Built with