PaymentWithBeneficiaryCreate

clientIdstring

Required if the beneficiary belongs to your client

Example: 401f4647-8372-495f-8de0-aafb3e1eaf93

currencyCodestringrequired

Three letters payment currency code

Possible values: <= 3 characters

Example: USD

sellCurrencyCodestring

Three letters sell currency code if FX included

Possible values: <= 3 characters

Example: AUD

quotationIdstring

Quatation id if FX included

amountnumber<double>required

Payment amount on payment currency (maximum 2 decimal places)

Possible values: >= 1

Example: 10000.55

chargeTypePaymentChargeTypesrequired

Payment charge type if it is a swift payment

Possible values: [SHARED, OURS]

Example: SHARED

paymentReferencestringrequired

Payment Reference. Allowed characters: letters, digits, spaces and / - ? : ( ) . , ' +

Possible values: <= 64 characters, Value must match regular expression ^[a-zA-Z0-9/\-?:().,'+ ]+$

Example: Invoice-123

paymentDatestringrequired

Payment date (in formart YYYY-MM-DD)

Example: 2024-07-30

purposeCodePaymentPurposeCodesrequired

Purpose code of the payment

Possible values: [DEBT, FAMILY, GOODS, SERVICES, HIGH_VALUE_ITEM, INVESTMENT, SAVING, COMPANY_MANAGE, INTER_GROUP_TRANSFER, FREIGHT]

Example: GOODS

sourceOfFundsPaymentFundSourceTypes

Source of payment fund. Conditionally required: Required for (1) local payments, or (2) POBO SWIFT payments to personal beneficiaries. Optional for other payment types.

Possible values: [Salary, Savings, Loan, Business Income]

Example: Business Income

invoiceNumberstring

Invoice number, Conditionally required: Required for local INR payments to business beneficiaries. Allowed characters: letters, digits and - _ /

Possible values: <= 32 characters, Value must match regular expression ^[A-Za-z0-9\-_/]+$

invoiceDatestring

Invoice date for the payment (in formart YYYY-MM-DD), Conditionally required: Required for local INR payments to business beneficiaries.

Example: 2024-06-30

referenceIdobject<^[a-zA-Z0-9_][a-zA-Z0-9_-]{0,35}$>nullable

The unique reference id of payment creation. Optional, but highly recommended to use. When given, it fails the creation if a duplicate payment is found. Only alphanumeric characters, underscores and hyphens are allowed, and cannot start with a hyphen.

Possible values: <= 36 characters

Example: 1234567890

beneficiaryTypeBeneficiaryTyperequired

Type of beneficiary

Possible values: [BUSINESS, PERSONAL]

Example: BUSINESS

beneficiary objectrequired

Beneficiary information (structure depends on beneficiaryType). Currency code and client ID will be inherited from payment.

oneOf

• BusinessBeneficiaryForPayment
• PersonalBeneficiaryForPayment

countryCodestringrequired

ISO 3166-1 alpha-2 country code

Possible values: >= 2 characters and <= 2 characters

Example: AU

emailstring

Beneficiary email

Possible values: <= 128 characters

Example: contact@abc.com

phoneNumberstring<E.164>

Beneficiary phone number,E.164 formatted

Possible values: <= 32 characters

Example: +61299998888

address object

Beneficiary address

streetstring

Business official street address. Allowed characters: letters, digits, spaces and , . - / # ( ) : '

Possible values: >= 4 characters and <= 256 characters, Value must match regular expression ^[A-Za-z0-9\s,.\-/#():']+$

Example: 19 Victoria Ave

citystring

City name of business official address. Allowed characters: letters, spaces and - . '

Possible values: <= 128 characters, Value must match regular expression ^[A-Za-z\s\-.']+$

Example: Sydney

statestring

State name of business official address. Allowed characters: letters, spaces and -

Possible values: <= 128 characters, Value must match regular expression ^[A-Za-z\s\-]+$

Example: New South Wales

zipstring

Zip code of business official address. Allowed characters: letters, digits, hyphens and spaces

Possible values: <= 32 characters, Value must match regular expression ^[A-Za-z0-9\- ]+$

Example: 2000

uniquePayIdstring

CAPAY FastID if the beneficiary is a CAPAY client too (Either uniquePayId or bankAccount must be provided)

Possible values: <= 32 characters

referenceIdstring<^[a-zA-Z0-9_][a-zA-Z0-9_-]{0,35}$>

The unique reference id of this entity creation. Optional, but highly recommended to use. When given, it fails the creation if a duplicate entity is found. Only alphanumeric characters, underscores and hyphens are allowed, and cannot start with a hyphen.

Possible values: <= 36 characters

Example: 1234567890

nickNamestring

Nickname of the beneficiary. Allowed characters: letters, digits, spaces and / & - . , ' +

Possible values: <= 128 characters, Value must match regular expression ^[a-zA-Z0-9/&.,'\- +]+$

Example: ABC

namestringrequired

Name of the beneficiary. Allowed characters: letters, digits, spaces and / & - . , ' +

Possible values: <= 128 characters, Value must match regular expression ^[a-zA-Z0-9/&.,'\- +]+$

Example: ABC Pty Ltd

bankAccount object

Beneficiary bank account (Either uniquePayId or bankAccount must be provided). Currency code will be inherited from payment.

countryCodestringrequired

ISO 3166-1 alpha-2 country code

Possible values: >= 2 characters and <= 2 characters

Example: AU

bankTypeBankTypesrequired

Bank type

Possible values: [SWIFT, LOCAL]

Example: SWIFT

bankNamestringrequired

Bank name. Allowed characters: letters, digits, spaces and / & - . , ' +

Possible values: <= 256 characters, Value must match regular expression ^[a-zA-Z0-9/&.,'\- +]+$

Example: Bank Of America

accountNamestringrequired

Bank account name. Allowed characters: letters, digits, spaces and / & - . , ' +

Possible values: <= 256 characters, Value must match regular expression ^[a-zA-Z0-9/&.,'\- +]+$

Example: ABC Pty Ltd

routingNoTypeRoutingNoTypes

Routing type

Possible values: [ABA, ACH, BIC, BSB, Fedwire, IBAN, IFSC, Branch Code, Routing Code, Sort Code, SWIFT, SWIFT/BIC, Routing Number, CNAPS, BANK CODE, None, Transit Number]

Example: BSB

routingNumberstring

Routing number

Possible values: <= 64 characters

Example: 012999

routingNoType1RoutingNoTypes1

Extra routing type, Conditionally required: (1) 12 digits, CNAPS is required when Payment Type is 'OURS'. (2) 6 digits, Sort Code is required if the beneficiary bank is located in the UK, Guernsey, Isle of Man, or Jersey.

Possible values: [ABA, ACH, BIC, BSB, Fedwire, IBAN, IFSC, Branch Code, Routing Code, Sort Code, SWIFT, SWIFT/BIC, Routing Number, CNAPS, BANK CODE, None, Transit Number]

Example: BANK CODE

routingNumber1string

Routing number for the extra routing type

Example: 012999

accountNumberstringrequired

Bank account number

Possible values: <= 64 characters

Example: 999000123

accountTypeBankAccountTypes

Bank account type

Possible values: [SAVINGS, CHECKING]

Example: SAVINGS

address object

Bank address

streetstring

Business official street address. Allowed characters: letters, digits, spaces and , . - / # ( ) : '

Possible values: >= 4 characters and <= 256 characters, Value must match regular expression ^[A-Za-z0-9\s,.\-/#():']+$

Example: 19 Victoria Ave

citystring

City name of business official address. Allowed characters: letters, spaces and - . '

Possible values: <= 128 characters, Value must match regular expression ^[A-Za-z\s\-.']+$

Example: Sydney

statestring

State name of business official address. Allowed characters: letters, spaces and -

Possible values: <= 128 characters, Value must match regular expression ^[A-Za-z\s\-]+$

Example: New South Wales

zipstring

Zip code of business official address. Allowed characters: letters, digits, hyphens and spaces

Possible values: <= 32 characters, Value must match regular expression ^[A-Za-z0-9\- ]+$

Example: 2000

PaymentWithBeneficiaryCreate

{
  "clientId": "401f4647-8372-495f-8de0-aafb3e1eaf93",
  "currencyCode": "USD",
  "sellCurrencyCode": "AUD",
  "quotationId": "string",
  "amount": 10000.55,
  "chargeType": "SHARED",
  "paymentReference": "Invoice-123",
  "paymentDate": "2024-07-30",
  "purposeCode": "GOODS",
  "sourceOfFunds": "Business Income",
  "invoiceNumber": "string",
  "invoiceDate": "2024-06-30",
  "referenceId": "1234567890",
  "beneficiaryType": "BUSINESS",
  "beneficiary": {
    "countryCode": "AU",
    "email": "contact@abc.com",
    "phoneNumber": "+61299998888",
    "address": {
      "street": "19 Victoria Ave",
      "city": "Sydney",
      "state": "New South Wales",
      "zip": "2000"
    },
    "uniquePayId": "string",
    "referenceId": "1234567890",
    "nickName": "ABC",
    "name": "ABC Pty Ltd",
    "bankAccount": {
      "countryCode": "AU",
      "bankType": "SWIFT",
      "bankName": "Bank Of America",
      "accountName": "ABC Pty Ltd",
      "routingNoType": "BSB",
      "routingNumber": "012999",
      "routingNoType1": "BANK CODE",
      "routingNumber1": "012999",
      "accountNumber": "999000123",
      "accountType": "SAVINGS",
      "address": {
        "street": "19 Victoria Ave",
        "city": "Sydney",
        "state": "New South Wales",
        "zip": "2000"
      }
    }
  }
}