Money object

Attributes

Attribute	Type	Description
`amount`	string `required`	The amount is a string representation of a decimal number, rounded to 2 decimal places.
`currency`	string `required`	The currency in ISO 4217 format. Only “GBP” is supported.

422 Errors

Where a Money object is included in an API request, it will be validated according to the specification above. Invalid Money objects will trigger a 422 Unprocessable Entity response. The following is a list of common examples.

Example	errorCode	message
`amount` is omitted or null	`invalid_object`	`{Money object}`.amount Amount field required
`amount` has more than 2 decimal places	`invalid_object`	amount. must be a valid ISO 4217 format value
`amount` includes a thousands separator comma, for example: “1,000”	`invalid_amount`	Amount must be a valid ISO 4217 format value
`amount` is not a decimal number, for example: “FREE”, “£2” or an empty string	`invalid_object`	`{Money object}`.amount Amount field must be a valid ISO 4217 format value
`currency` is omitted or null	`invalid_object`	`{Money object}`.currency Currency field required
`currency` is not a valid currency code, not all uppercase or an empty string	`invalid_object`	`{Money object}`.currency Currency not supported for this merchant
`currency` is supported by Clearpay, but not valid for the Merchant account	`unsupported_currency`	An error occurred

Example Money object

1 {
2   "amount": "29.99",
3   "currency": "GBP"
4 }