A payer is someone who you are going to debit. It stores basic information about the person and also their bank details.
id string | The ID of the payer. Payers are always prefixed with "pyr_" |
firstName | First Name |
lastName | Last Name |
emailAddress | Email Address |
mobileNumber | Mobile Number |
streetAddress | Street Address |
suburb | Suburb, District or County |
postCode | Postcode or Zip Code |
state | State or Region |
country | Country |
companyName | The company name for the payer record if not a person |
companyRegistrationNumber | The government assigned company number for identification purposes if the payer is not a person |
metadata | A JSON array of metadata objects. Extra information that may be included for integration purposes. |
agreements | A list of agreements for the current Payer. An agreement represents a contract between the Payer and Pinch to allow for direct debiting of their bank account. Also known as a Direct Debit Request or DDR. |
sources | A list of stored payment sources for the payer. May or may not be reusable for future transactions. |
Agreement
id string | The Id for the agreement. Prefixed with "agr_". |
anonymousViewToken | Allows the user to access the PDF copy of the contract anonymously for a short period of time. |
agreementDateUtc | The date that the agreement contract was generated. |
confirmedDateUtc | The date that the user confirmed and agreed to the agreement contract. |
Source
id string | The ID for the source. Prefixed with "src_". |
sourceType | The type of source. "bank-account" or "credit-card". |
bankAccountNumber | The bank account number |
bankAccountBsb | The bank account routing number. (BSB in Australia). |
bankAccountName | The name of the bank account owner |
token | The token used to store the bank account. Returned by the tokenisation endpoint. |
cardHolderName | The name of the credit card owner |
expiryDate | The expiry date of the credit card |
displayCardNumber | The last 4 digits of the credit card or bank account. For display purposes. |
cardScheme | The credit card scheme: "visa", "mastercard", "amex", etc... |
origin | The country of origin for the bank account or credit card. 2 digit country code as per: ISO 3166-1 alpha-2. |
funding | The funding source of the credit card. Can be "credit", "debit", "prepaid", "charge", "deferred-debit". |
isAuthorised | Used mostly for credit cards, it shows whether the card has been authorised succesfully (either a zero dollar authorisation, or a successful payment). |
supportsRealtime | Whether this source can be used with the realtime payment endpoint. |