Skip to content
English
Go to Zai
  • There are no suggestions because the search field is empty.

Payment Descriptors

Information about descriptors that appear in your user's bank statements.

Overview

Descriptors allow you to provide additional information to your users about what a payment is for and who it is from. This helps your customers recognise the transaction and can reduce chargebacks, disputes or queries from customers.

How it works

A descriptor is set in one of two ways with Zai, either with a default descriptor or a custom descriptor that you pass to the relevant API object.

Default Descriptors

The following descriptors are shown by default.

Payins

Australia:
  • Direct debit ZAI [User name] or ZAI [Platform name], maximum of 18 characters with 13 usable.
  • Credit card - ZAI*[User name] or ZAI*[Platform name], maximum of 22 characters with 18 usable.

Payouts

Australia:
  • International wire payout - ZAI*[Platform name], maximum characters varies depending on the recipient bank. Often 18 characters with 14 usable.
  • Direct entry / direct credit - ZAI* [4 digit batch ID]: Platform name, maximum of 18 characters with 13 usable.
  • Realtime payout - ZAI*[Platform Name] maximum of 280 characters with 276 usable.
  • PayPal payout - ZAI*[Platform Name], maximum of 22 characters, with 18 usable.

Custom Descriptors

The following descriptors can be set using a custom value.

Payins

Australia:
  • Direct Debit - using the custom_descriptor field on an Item, you can change what is displayed, see Create Item for more information. Format will be ZAI*[custom_descriptor] with a maximum of 18 characters and 13 usable.
  • Credit Card - using the custom_descriptor field on an Item, you can change what is displayed, see Create Item for more information. Format will be ZAI*[custom_descriptor] with a maximum of 22 characters and 18 usable.

Payouts

  • Australia:
    • Realtime Payout - when using the custom_descriptor field on the withdraw call of a user's wallet, you can control what appears on the bank statement. Format will be ZAI*[custom_descriptor] with a maximum of 280 characters and 200 usable.