[DEPRECATED] Withdrawals from Peer 2 Peer

This page describes withdrawal options for a deprecated Peer 2 Peer system.

Initiates withdrawal of fiat funds using a card (v2)

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

Headers

Name	Type	Description
x-api-key*	String	Your API key

Request Body

Name	Type	Description
customerId*	String	The unique customer ID who initiated the withdrawal
amount*	String	The amount to withdraw
currency*	String	The currency to withdraw in
orderId	String	The unique order ID in your system
applicationId	String	The application ID if you have multiple
comment	String	The comment (max 255 symbols)
paymentSystem	String	The payment system to process withdrawal with
cardHolderName	String	The name on the card to withdraw to
cardNumber*	String	The card number to withdraw to

Example of the request body

{
    "amount": "1000",
    "applicationId": "test_application_id",
    "cardHolderName": "John Doe",
    "cardNumber": "4242424242424242",
    "comment": "fiat withdrawal using a card",
    "currency": "INR",
    "customerId": "21c5e78e-95b9-11ed-a1eb-0242ac120002",
    "orderId": "ef3e9b1e-712a-4122-848f-4838a167861b",
    "paymentSystem": "UPI"
}

Initiates withdrawal of fiat funds using a phone number (v2)

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

Headers

Name	Type	Description
x-api-key*	String	Your API key

Request Body

Name	Type	Description
customerId*	String	The unique customer ID who initiated the withdrawal
amount*	String	The amount to withdraw
currency*	String	The currency to withdraw in
orderId	String	The unique order ID in your system
applicationId	String	The application ID if you have multiple
comment	String	The comment (max 255 symbols)
paymentSystem	String	The payment system to process withdrawal with
phoneNumber*	String	The recipient phone number
bankName	String	The bank name, where there's an account with the provided phone number

Example of the request body

{
    "amount": "1000",
    "applicationId": "test_application_id",
    "bankName": "Bank Inc.",
    "comment": "fiat withdrawal using a phone number",
    "currency": "INR",
    "customerId": "21c5e78e-95b9-11ed-a1eb-0242ac120002",
    "orderId": "ef3e9b1e-712a-4122-848f-4838a167861b",
    "paymentSystem": "UPI",
    "phoneNumber": "[phone]"
}

Initiates withdrawal of fiat funds using a bank account (v2)

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

Headers

Name	Type	Description
x-api-key*	String	Your API key

Request Body

Name	Type	Description
customerId*	String	The unique customer ID who initiated the withdrawal
amount*	String	The amount to withdraw
currency*	String	The currency to withdraw in
orderId	String	The unique order ID in your system
applicationId	String	The application ID if you have multiple
comment	String	The comment (max 255 symbols)
paymentSystem	String	The payment system to process withdrawal with
bankName	String	The bank name
bankAccountName*	String	The bank account name
bankAccountNumber*	String	The bank account number

Example of the request body

{
    "amount": "1000",
    "applicationId": "test_application_id",
    "bankAccountName": "John Doe",
    "bankAccountNumber": "AA0000000000000000000000000",
    "bankName": "Bank Inc.",
    "comment": "fiat withdrawal using a phone number",
    "currency": "INR",
    "customerId": "21c5e78e-95b9-11ed-a1eb-0242ac120002",
    "orderId": "ef3e9b1e-712a-4122-848f-4838a167861b",
    "paymentSystem": "UPI"
}

If applicationId and orderId are passed when creating an invoice, the callback will contain them after the transaction is processed.

Results