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.
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 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 |
| receiveMethod | No | This field specifies the receive method of the contact for the current payment. Possible values are CARD, BANK_ACCOUNT, PAYPAL or VENMO. | String |
| receiveMethodId | No | The specified receive method ID of a contact. If you wish to pay to a specific bank account of a contact then that bank account id has to be provided here. | String |
| settlementSpeed | No | This field specifies the preferred settlement speed for transferring funds to the contact's bank account. Different speeds may impact transaction costs and availability of funds. Common options include: REAL_TIME (Instant), T_0 (Within 24 hours) and T_1 (Next-Day). | String |