Skip to main content

API references

This section contains standardized reference values, formats, and validation rules used throughout the Getpaid API. Use these information to understand data format requirements, supported values, and constraints when integrating with the Getpaid API.

TypeDescriptionReference
CountryCountries is referenced by its ISO 3166-1 alpha-2 code in uppercase. For example, DE or US.ISO 3166-1 alpha-2 country codes
CurrencyCurrencies are specified using the ISO 4217 codes in uppercase. For example, EUR or USD.ISO 4217 currency codes
File MIME typeSupported file formats for document uploads and a correlation between the file format and its MIME type.Files MIME types
Reason codeGetpaid solution resources statuses and be detailed using reason codes. Each resource could contain a different list of reason codes by status with its description and recommended action. See how statuses reasons are described in the API responses.Resources index
Registration numberCompany registration number formats support for each country.Registration numbers
StatusGetpaid solution resources, when can change over time, define its own status with a list of descriptive values and transition rules. Some statuses can also define a more detailed reason specifying a reason code.Resources index

Resources

Index of status and reason codes of the API resources including them.

ResourceStatusesReason codes
CheckoutsCheckout statuses-
PaymentsPayment statusesPayment reason codes
RefundsRefund statusesRefund reason codes