HomeGuidesRecipesAPI ReferenceChangelog
Log In
Changelog
Start typing to search…
Back to All

SANDBOX- v2.3.3 - 2025-12-15

about 11 hours ago by Marc Cimiotta Ferrando

🚀 Sandbox Update Going Live 🎉

This update adds new off-ramp currencies and blockchain support, improves US onboarding and KYC flows, introduces a new user status, and makes KYC and beneficiary handling clearer.

✨ Highlights

  • ✅ New off-ramp currencies available in Sandbox
  • ✅ On/off-ramp USDC and USDT on Avalanche
  • ✅ US users supported in Share Applicant to DTR flow
  • ✅ New US fields: mailing_address, occupation
  • ✅ Missing legal documents now visible in KYC details
  • ✅ Beneficiary schema simplification for TRY, INR, MXN (backwards compatible)
  • ✅ New SUSPENDED user status
  • ✅ New Sandbox endpoint to simulate transaction webhooks

🌍 New currencies & blockchain support

New off-ramp currencies (Sandbox)

  • 🇦🇷 ARS — Argentine Peso
  • 🇮🇩 IDR — Indonesian Rupiah
  • 🇵🇭 PHP — Philippine Peso

Sandbox testing note

To test these currencies in Sandbox, please contact us to receive the required test data.

Avalanche support

Users can now on/off-ramp USDC and USDT from Avalanche wallets.

🇺🇸 US onboarding & KYC updates

Share Applicant to DTR flow

US users can now be exported through the share token flow.
Contact us to enable it.

US phone rules

Phone handling is consistent across flows:

  • Create User (US): required, unique, E.164 format
  • Create Applicant (US): required if missing from user record
  • Update User: switching to US requires an E.164 number
  • Non-US: optional, must follow E.164 if provided

New fields for US users

Added to meet risk assessment, unclaimed property, and tax compliance needs:

  • mailing_address (object)
  • occupation (dropdown)

Endpoints affected:

  • POST /kyc/applicant
  • PATCH /user

🧾 KYC visibility improvements

Missing legal documents

The KYC details endpoint now returns missing_legal_documents.

If KYC checks pass but required documents are not signed:

  • User remains in KYC_PENDING
  • Status moves to FULL_USER once all documents are signed

💱 Beneficiary schema updates

TRY, INR, MXN beneficiary simplification

The following currencies now use a simplified beneficiary schema:

  • TRY — Turkish Lira
  • INR — Indian Rupee
  • MXN — Mexican Peso

Removed non-essential fields:

  • Beneficiary address
  • Bank address
  • Beneficiary phone number

Core account details remain unchanged.

Note: These changes are backwards compatible. Existing integrations continue to work without changes.

🚫 User restrictions

SUSPENDED status

Used when compliance or risk teams need to restrict a user.

While suspended:

  • No updates or transactions allowed
  • All actions return 403 with message:
    User with UUID is suspended and cannot perform the requested action.
  • KYC is paused until review completes
  • Can be temporary or permanent

🧪 Sandbox testing tools

Simulate transaction webhook (NEW)

A new Sandbox-only endpoint lets you trigger transaction webhooks to test your webhook handling logic.

Endpoint

POST https://sandbox.getunblock.com/sandbox/simulate/transaction-webhook

What it does

  • Simulates webhooks for fiat-to-crypto and crypto-to-fiat flows
  • Supports different webhook types and subtypes
  • Useful for testing success and failure scenarios

Notes

  • Only available in Sandbox
  • Either user_uuid or corporate_uuid is required (not both)

Thanks for building with us! 🙌