TRY Bankpay/Havale withdrawals#

Withdrawal endpoint#

Make a withdrawal request using the API V.2 endpoint (see the withdrawal initiation with API page for the full OpenAPI specification):

POST https://api.xgateway.tech/api/v2/withdrawal

Required Payload#

To initiate a withdrawal in TRY currency from your Bankpay account, please provide the following parameters in the withdrawal request

Parameter	Mandatory	Description
amount	true	String representation of requested amount. Should be multiple of 50.
applicationId	false	Application ID in case the application is used
customerId	true	Customer id in the merchant system
orderId	false	Invoice id in the merchant system. If provided, used as an idempotency key.
currency	true	String representation of the requested currency. Should be TRY in this case.
beneficiaryAccountNumber	true	Customer's IBAN.
beneficiaryName	true	Customer’s first name and last name in string format
beneficiaryEmail	false	Customer's email address.
paymentMethod	true	Payment method name. Should be "bankpay" in this case.

Payload example

{
    "beneficiaryAccountNumber": "TR330006100519786457841326",
    "beneficiaryEmail": "[email protected]",
    "beneficiaryName":"John Doe",
    "currency": "TRY",
    "amount": "50",
    "customerId": "test_customer_id",
    "paymentMethod": "bankpay"
}

Deposit and withdrawal amounts in TRY must be multiples of 50.