Skip to main content

Credit2Crypto

CREDIT2CRYPTO request

CREDIT2CRYPTO request is used to create CREDIT transaction in Payment Platform.

This operation transfers funds from merchant's crypto wallet to customer.

This request is sent by POST in the background (e.g., through PHP CURL).

Request parameters

ParameterDescriptionValuesRequired
actionCREDIT2CRYPTOCREDIT2CRYPTO+
client_keyUnique client key (CLIENT_KEY)+
channel_idPayment channel (Sub-account)String up to 16 characters-
brandBrand through which the transaction is performedString up to 36 characters+
order_idOrder ID in the Clients systemString up to 255 characters+
order_amountThe amount of the transactionFormat depends on currency+
order_currencyCrypto currencyalpha code, from 3 to 6 characters+
order_descriptionDescription of the transaction (product name)String up to 1024 characters+
crypto_networkBlockchain networkString up to 50 characters

You can use an arbitrary value or choose one of the following:
• ERC20
• TRC20
• BEP20
• BEP2
• OMNI
• solana
• polygon
-
parametersArray of the parameters for specific brand(Appendix C)-
return_urlIf the optional parameter return_url is not provided in the request, the customer will be redirected to the default 'Thank You' page after the payment process. This page includes an option to send the receipt to the customer's emailExample: https://example.domain.com-
hashSpecial signature to validate your request to Payment PlatformSee Appendix A, Credit2Virtual signature.+

Response Parameters

You will get JSON encoded string with transaction result.

Synchronous - INIT transaction response (for crypto flow)

ParameterDescription
actionCREDIT2CRYPTO
resultINIT / UNDEFINED / DECLINED
statusPENDING if success
PREPARE if undefined status
DECLINED if fail
order_idOrder ID in the Client’s system
trans_idTransaction ID in the Payment Platform
trans_dateTransaction date in the Payment Platform
descriptorAdditional payment description
amountOrder amount
currencyCurrency

Callback Parameters

Callback - INIT transaction response

ParameterDescription
actionCREDIT2CRYPTO
resultINIT
statusPENDING if success
DECLINED if fail
order_idOrder ID in the Client’s system
trans_idTransaction ID in the Payment Platform
trans_dateTransaction date in the Payment Platform
descriptorAdditional payment description
amountOrder amount
currencyCurrency

Callback - Successful response

ParameterDescription
actionCREDIT2CRYPTO
resultSUCCESS
statusSETTLED
order_idOrder ID in the Client’s system
trans_idTransaction ID in the Payment Platform
amountOrder amount
currencyCurrency
trans_dateTransaction date in the Payment Platform

Callback - Unsuccessful response

ParameterDescription
actionCREDIT2CRYPTO
resultDECLINED
statusDECLINED
order_idOrder ID in the Client’s system
trans_idTransaction ID in the Payment Platform
amountOrder amount
currencyCurrency
trans_dateTransaction date in the Payment Platform
decline_reasonThe reason why the transaction was declined

Callback - Undefined response

ParameterDescription
actionCREDIT2CRYPTO
resultUNDEFINED
statusPREPARE / PENDING
order_idOrder ID in the Client’s system
trans_idTransaction ID in the Payment Platform
trans_dateTransaction date in the Payment Platform
amountOrder amount
currencyCurrency