1. API DOC | EN
Instatnt2
  • API DOC | EN
    • Introduction
    • Glossary
    • Authorization key
    • Sandbox
    • Additional fields
    • Currencies
    • Bank names
    • Telecom operators
    • Callbacks
    • Payment history
    • Error descriptions
    • Tech FAQ
    • Events
    • Integratins
      • Stripe
      • Inwizo
      • 2Checkout
      • Adyen
      • AffiniPay
      • Alikassa
      • AlliancePay
      • Amazon Pay
      • AnyMoney
      • AstroPay
      • Aureavia
      • AurisMyChanger
      • Authorize.Net
      • Avatarix
    • Balance H2H
      GET
    • Deposit H2H - Card & P2P
      POST
    • Deposit H2H - Token
      POST
    • Deposit H2C - Card
      POST
    • Deposit status H2H - Instant ID
      GET
    • Deposit status H2H - Merch ID
      GET
    • Payout H2H
      POST
    • Payout status H2H - Instant ID
      GET
    • Payout status H2H - Merch ID
      GET
  1. API DOC | EN

Deposit H2C - Card

POST
https://init.InstantTransfer.tech/api/v1/integration/deposit-order/
PCI DSS NOT REQUIRED
If you do not have a PCI DSS certificate, you can use this method. In this case, you must not collect the user's card details when creating the payment โ€” the user will be presented with a Payment web page to enter their card information at the next step.
If you have a PCI DSS certificate, please refer to the following method: secure.InstantTransfer.tech/api/v1/integration/deposit-order
Payment Status Verification Before Cascading
Errors and missing responses during payment creation may occur due to transient or unforeseen circumstances and do not reliably indicate the final payment status. If you receive a 499+ error, any other error, or no response at all, for example due to a broken connection or timeout, check the payment status in our system before sending the payment through the cascade.

To make deposit payment please use follow sections:#

Create payment (current method): POST payform.InstantTransfer.tech/api/v1/integration/deposit-order/
Get status: GET init.InstantTransfer.tech/api/v1/integration/deposit-order/{externalId}/status
Get status by Callback

Create H2H Deposit with the banking card - Sequence diagram#

Glossary: User | Merchant | InstantTransfer.tech | ACS | Order | 3DS URL | Callback

CURL Example | POST Deposit order#

curl --request POST \
 --url https://init.InstantTransfer.tech/api/v1/integration/deposit-order\
 --header 'Authorization: Bearer YOUR TOKEN' \
 --header 'Content-Type: application/json' \
 --header 'accept: text/plain' \
 --data '{
  "amount": 100,
  "currency": "USD",
  "externalTransactionId": "MerchantPaymentId-12345",
  "successRedirectUrl": "http://merch.com/success",
  "failedRedirectUrl": "http://merch.com/failed",
  "processingRedirectUrl": "http://merch.com/processing",
  "additionalFields": [
   {
     "key": "payeerIdentifier",
     "value": "Merch-12345"
   },
   {
     "key": "email",
     "value": "Jhon.Wick@Continental-Hotel.com"
   }
 ]
}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json

Examples

Responses

๐ŸŸข200Success
application/json
Bodyapplication/json

๐ŸŸ 400Validation error
๐ŸŸ 400Payment already exist
๐ŸŸ 400Limit was reached
๐ŸŸ 401Unauthorized
๐ŸŸ 403Forbidden - Endpoint
๐ŸŸ 403Forbidden - IP address
๐ŸŸ 423Temporary error
๐Ÿ”ด500Internal Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://init.InstantTransfer.tech/api/v1/integration/deposit-order/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 100,
    "currency": "USD",
    "externalTransactionId": "MerchID-{{$number.int(min=1)}}",
    "callbackUrl": "https://merch.com/callbackUrl",
    "processingRedirectUrl": "https://merch.com/processing",
    "failedRedirectUrl": "https://merch.com/failed",
    "successRedirectUrl": "https://merch.com/success",
    "additionalFields": [
        {
            "key": "payeerIdentifier",
            "value": "Merch-12345"
        },
        {
            "key": "email",
            "value": "Jhon.Wick@Continental-Hotel.com"
        }
    ]
}'
Response Response Example
200 - Example 1
{
    "externalId": "e1537516-d160-48fa-b542-708d76d4c3ca",
    "orderStatus": "Init",
    "formUrl": "https://payform.InstantTransfer.tech?token=b226f7c4-7c95-4748-8da5-05f369f75cea"
}
Modified atย 2026-06-08 12:37:07
Previous
Deposit H2H - Token
Next
Deposit status H2H - Instant ID
Built with