post https://prod.api.getborderless.com/payments
Introduction
This endpoint executes single payment.
Data Requirements
Provide the following data requirements when sending a POST request to the Submit Payment.
Additional Header parameter:
| Parameter | Required? | Description | Type |
|---|---|---|---|
| Client-Id | No | Unique identifier of Child Account (required only for Partner). See Authentication Page to learn more. | String |
The body of this request should contain the following parameters:
| Parameter | Required? | Description | Type |
|---|---|---|---|
| handle | Yes | The borderless™ username (@handle) of the customer you would like to request payment from, without the “@” symbol. Read more about borderless™ @handles . | String |
| amount | Yes | Non-negative amount to create payment request. | Number |
| description | Yes | A customized message describing the nature and reason for the payment. | String |
| popCode | Yes | Purpose Of Payment (known as “POP”) code that denotes the reason for the payment required for compliance. You can retrieve those via Reference Section of the API. | String |
| exchangeCurrencyBasis | No | Exchange Currency Basis defines in whos currency (BENEFICIARY or PAYER) payment will be executed. Possible values are BENEFICIARY and PAYER. Default value is PAYER. | String |
| payerAcceptedFees | No | This field indicates who pays the transaction fee. The default value is set to false which means the recipient pays the fee. If set to true - payer will pay the fees. | Boolean |
| clientPaymentRef | No | This field is an optional reference to enrich the payment data for internal tracking or in order to quickly match payments between borderless and third party systems. This reference will be returned in the webhook of payment. | String |
| paymentMethod | No | This field specifies the payment method for the current payment. Possible values are BANK_ACCOUNT | FUNDING_BALANCE. | String |
| paymentMethodCurrency | No | This field specifies currency to be paid from. If FUNDING_BALANCE is specified as paymentMethod, then this field is required. | String |