Fields for Updating Invoice Settings

The update invoice settings request does not require a specific set of fields. Instead, you can choose the fields to include in your request based on aspects of your checkout experience, email communications, and payer authentication enablement.
Update Checkout Page Settings
Name
API Request Field
Description
Business Name
invoiceSettingsInformation.merchantDisplayName
The business name displayed on the invoice.
Currency
invoiceSettingsInformation.defaultCurrencyCode
The currency of the billed amount.
The currency code default value is set to
USD
 when this field is not specified.
Only three-character ISO Standard Currency Codes are accepted.
For more information, see ISO Standard Currency Codes reference guide..
Header Background Color
invoiceSettingsInformation.headerStyle.backgroundColor
The background color of the displayed invoice.
Only hexadecimal code values with a prefixed
#
 are accepted.
Example:
#000000
Header Font Color
invoiceSettingsInformation.headerStyle.fontColor
The invoice font color.
Only hexadecimal code values with a prefixed
#
 are accepted.
Example:
#000000
Logo
invoiceSettingsInformation.merchantLogo
The binary format of your logo that determines the image displayed to your customers.
Image files are restricted to 1 MB and must be encoded in Base64 format. These are the supported file types:
  • gif
  • jpg
  • png
VAT Tax Number
invoiceSettingsInformation.vatRegistrationNumber
The government-assigned tax identification number.
VAT Tax Number Displayed
invoiceSettingsInformation.showVatNumber
The toggle for displaying the VAT tax number in the invoice.
Possible values:
  • false
    : Do not display the VAT tax number.
  • true
    : Display the VAT tax number.
Update Email Communication Settings
Name
API Request Field
Description
Email Message
invoiceSettingsInformation.customEmailMessage
The custom message in the invoice email.
Email Reminder
invoiceSettingsInformation.enableReminders
The toggle for sending an email reminder to the customer five days before the invoice due and one day after it is past due.
Possible values:
  • False
    : No email reminder is sent.
  • True
    : Email reminders are sent.
Language
invoiceSettingsInformation.deliveryLanguage
The language of the email message sent to the customer.
Set to one of these possible values:
  • de-DE
    : German (Germany)
  • en-US
    : English (United States)
  • es-419
    : Spanish as used in Latin America and the Caribbean
  • fr-FR
    : French (France)
  • ja-JP
    : Japanese (Japan)
  • pt-BR
    : Portuguese (Brazil)
  • ru-RU
    : Russian (Russia)
  • zh-CN
    : Chinese (Simplified, People's Republic of China)
  • zh-TW
    : Chinese (Traditional, Taiwan)
Payer Authentication Enablement Settings
Name
API Request Field
Description
Payer Authentication Enablement
invoiceSettingsInformation.payerAuthenticationInInvoicing
The indicator for payer authentication enablement.
Possible values:
  • disable
    : Disable 3-D Secure
  • enable
    : Enable 3-D Secure payer authentication
For more information about including payer authentication to your invoices, see Add Payer Authentication to Invoicing.