Custom Fields

Add custom data to your request payload

Crafting Metadata

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}