Payment Initiation
Creates new Payment order
Endpoint
Request Type | URL |
|---|---|
POST | https://{EnvironmentURL}/api/core/customers/{customerId}/payments/initiate |
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
Created Payment Order
Name | Type | Mandatory | Description |
|---|---|---|---|
id | uuid | Yes | Identifier of created Payment Order |
createdBy | uuid | Yes | Identifier of User, Creator of the Payment Order |
createdUtc | datetime | Yes | Moment of Payment order creation |
Order fields | All the Payment order fields received in request |
404 Not found
Contact or Account with given Id Not found
400 Bad request
Invalid format of the request
401 - Unauthorized
No Body