PRODUCTION - 2.3.2 - 2025-10-11

🚀 API Update Live in Production! 🎉
This update brings improvements to data validation, KYB flows, onboarding logic, and merchant fee management. Sandbox documentation will be updated shortly. If you see unexpected behavior, please reach out and we’ll help.

✨ Highlights
✅ Name input now follows consistent rules
✅ Phone number rules aligned with compliance requirements
✅ KYB now supports a new REJECTED state
✅ Merchant status notifications extended
✅ US onboarding more flexible
✅ Merchant fee update endpoint now supports minimum fee currency

🔍 Changes in Detail

1) Name Rules

• Only Latin alphabet characters are accepted.
• Names with accented characters (e.g., José) are not supported.
• First + last name combined max length: 50 characters.
• If the format or length fails, the API returns 400 – input validation error.

2) Phone Number Handling

• Phone numbers must be unique per user under the same merchant.

3) KYB Enhancements

• New REJECTED status added to KYB verification.
• Rejection reasons are included and can be parsed.
• Updated in the following endpoints/webhooks:
  • KYB Webhooks
  • Get Corporate Details
  • [Sandbox] PATCH KYB verification status

4) Merchant Deactivation

• A new Deactivated status is now supported.
• Merchants will be notified before the action takes effect.
• A webhook is sent when the status changes.

5) US Onboarding

• For US users, phone number is now optional when calling POST /createUser.

6) Update Merchant Fees

• Endpoint: PATCH https://sandbox.getunblock.com/merchant/fees
• Updates merchant fees and allows filtering for specific fees via fee configuration parameters.
• New field: minimum_fee_currency (string, enum) – REQUIRED when minimum_fee is defined. Specifies the currency in which the minimum fee is charged.

If you have questions or feedback, ping us on Slack — we’re here to help.