Beneficiary Name Validation Based on Beneficiary Type - Introduction to Tazapay

Release type: Enhancement Applies to: Beneficiary — Create Beneficiary

Summary

The name field in Create Beneficiary is now validated against a format that depends on the beneficiary type. Requests with a name that doesn’t match the format for the given type are rejected with a validation error.

What Changed

`type`	Validation rule
`individual`	Rejected if the name doesn’t start with a letter, is empty or only spaces, or contains special characters such as `@ # / _ $ % & ( ) .`
`business`	Latin letters (including accented letters), Chinese (Han) characters, digits `0-9`, spaces, and the characters `& , . ' ( ) -`. Full-width `（）` `，` `、` `·` are also allowed.

The existing 140-character maximum for name still applies.

Examples

`type`	`name`	Result
`individual`	`Mary-Jane O'Neil`	Accepted
`individual`	`José Álvarez`	Accepted
`individual`	`123 John`	Rejected
`individual`	`John_Smith`	Rejected
`individual`	`J.Smith`	Rejected
`individual`	`John..Smith`	Rejected
`individual`	`.John`	Rejected
`individual`	`John 123 @ Smith`	Rejected
`business`	`Acme Trading (Pte) Ltd`	Accepted
`business`	`上海贸易有限公司`	Accepted
`business`	`Acme Trading #1 / Ltd`	Rejected

What you need to do

Make sure the beneficiary name you send follows the format for its type. Requests with a name that doesn’t match are rejected, so check your inputs before calling the API.

Relevant Links

Create Beneficiary