Calculate transfer price
Returns Price and total Amount to be debited for given Payment order.
Endpoint
Request Type | URL |
|---|---|
POST | https://{EnvironmentURL}/api/core/customers/{customerId}/payments/calculate-price |
Headers
No headers
Request parameters
Parameter | Type | Mandatory | Description |
|---|---|---|---|
customerId | uuid | Yes | Identifier of the Customer, owner of the Account |
Request body
Body - JSON
Payment Order
Parameter | Type | Mandatory | Description |
|---|---|---|---|
debtorAccountId | uuid | Yes | Identifier of the Account |
payeeContactId | uuid | Yes | Identifier of stored Beneficiary Contact |
paymentRails | string | Yes | Payment Rails for transfer Allowed values:
|
paymentScheme | string | Yes | Payment Scheme if Payment Rails has multiple choice Applicable only for case when paymentRail = 'sepa' Allowed values:
|
amount | object | Yes | Amount to transfer |
amount.currencyCode | string | Yes | Code of the Currency of the amount Allowed values:
|
amount.value | decimal | Yes | Value of the amount |
paymentPurpose | string | No | Allowed values: See table below |
paymentPurposeText | string | No | Must be filled if option "Other" is chosen in paymentPurpose |
reference | string | Yes | Reference of the Payment |
requestedExecutionDate | datetime | No | YYYY-MM-DDTHH:MM:SS.NNNZ |
endToEndTransactionId | string | No | Transaction Id from the side of the Remitter |
Payment Purposes
Key | Description |
|---|---|
migrantTransfers | Outflows on account of migrant transfers including personal effects |
remittanceForFamily | Remittance for family maintenance and savings |
remittanceTowardsPersonal | Remittance towards personal gifts and donations |
education | Education (e.g. fees for correspondence courses abroad) |
healthService | Health Service (payment towards services received from hospitals, doctors, nurses, paramedical and similar services etc. rendered remotely or on-site) |
businessTravel | Business travel |
travelForPilgrimage | Travel for Pilgrimage |
travelForMedicalTreatment | Travel for medical treatment |
travelForEducation | Travel for education (including fees, hostel expenses etc.) |
otherTravel | Other travel (including holiday trips and payments for settling international credit cards transactions) |
other | Any other reasons |
Responses
200 OK - Success
Body - JSON
Name | Type | Mandatory | Description |
|---|---|---|---|
intialAmount | decimal | Yes | Initial value of Amount from Payment Order |
totalPrice | decimal | Yes | Price for requested Payment Order |
totalAmount | decimal | Yes | Total Amount will be charged from Account of the Customer (Initial Amount + Total Price) after execution of the Order |
404 Not found
Contact or Account with given Id Not found
401 - Unauthorized
No Body