Custom Fields

Add custom data to your request payload

Crafting Metadata

If you need to directly debit the customer in future, specify recurring=true under this object to ensure we accept only verve cards that support recurring billing. And force a bank authentication for MasterCard and VISA.

Crafting metadata will depend on your language's handling of JSON. Common metadata are:

  • Invoice ID
  • Cart ID
  • Cart Items
  • Payment medium (site/app)

The custom_fields key is reserved for an array of custom fields that should show in the email alert you get and on the dashboard when you click the transaction.

Custom fields have 3 keys: display_name, variable_name, and value. The display name will be the title for the value when displaying.

Sample

1"metadata":{
2 "cart_id":398,
3 "custom_fields":[
4 {
5 "display_name":"Invoice ID",
6 "variable_name":"Invoice ID",
7 "value":209
8 },
9 {
10 "display_name":"Cart Items",
11 "variable_name":"cart_items",
12 "value":"3 bananas, 12 mangoes"
13 }
14 ]
15}