Introduction

Coinpal is a non-custodial cryptocurrency payment processing platform. Accept payments in a wide range of cryptos and get them instantly converted into a coin of your choice and sent to your wallet.

SDKs&Demo

TODOS

Sandbox

TODOS

Authentication

TODOS

To use the Coinpal API you should do the following:

1 Sign up at merchant.coinpal.io

2 Fill in your business information

3 Generate an API key

Standard e-commerce flow for Coinpal API:

1 Please check whether the transaction currency is in the list we allow, if not, please convert it to the currency we need in time

2 API - Call the "POST Create payment" method to create a payment and get the deposit address;

3 UI - Ask a customer to send the payment to the generated deposit address;

4 UI - A customer sends coins, Coinpal processes and exchanges them (if required), and settles the payment to your Outcome Wallet;

5 API - You can get the payment status either via our IPN callbacks or manually, using "GET Payment Status" and display it to a customer so that they know when their payment has been processed.

6 UI - You can see all of this information in your Account on Coinpal Merchant website.

Payment API

POST Create payment

https://pay.coinpal.io/gateway/pay/checkout

Creates payment. With this method, your customer will be able to complete the payment without leaving your website. Data must be sent as a form-date payload.

Sign String Make Rule

sign = sha256(secretKey+requestId+merchantNo+orderNo+orderAmount+orderCurrency)

Parameters Body

Response Body (Success)

Response Body (Error)

Request Demo (PHP)

<?php
    //todo demo
    $url = "https://pay.coinpal.io/gateway/pay/checkout";
    $secretKey = '2bab786405d1279e825692e13245670379e6485a2fb701233e76d8f8b1482a9a';
    $data['version'] = '2';
    $data['requestId'] = 'TEST10000000000123';
    $data['merchantNo'] = '10000000';
    $data['merchantName'] = 'Cionpal';
    $data['orderNo'] = 'MER12345678910';
    $data['orderCurrencyType'] = 'fiat';
    $data['orderCurrency'] = 'USD';
    $data['orderAmount'] = '10.5';
    $data['orderDescription'] = 'Iphone 14';
    $data['payerIP'] = '192.168.0.1';
    $data['notifyURL'] = 'https://www.order-test.cn/notify.php?order='.$data['orderNo'];
    $data['redirectURL'] = 'https://www.order-test.cn';
    $data['remark'] = 'Remark';
    $data['sign'] = hash('sha256', $secretKey . $data['requestId'] . $data['merchantNo'] . $data['orderNo'] . $data['orderAmount'] . $data['orderCurrency']);

    function curl_request($url,$pdata){
        $ch = curl_init($url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $pdata);
        curl_setopt($ch, CURLOPT_TIMEOUT,60);
        $result = curl_exec($ch);
        if($result === false){
            return curl_error($ch);
        }
        curl_close($ch);
        return $result;
    }
    $order_data = curl_request($url,$data);

Query Payment (POST)

https://pay.coinpal.io/gateway/pay/query

Parameters Body

Response Body (Success)

Response Body (Error)

IPN(Callback)

When the payment status and payment amount change, we will notify your server in the form of asynchronous notification

sign = sha256(secretKey+requestId+merchantNo+orderNo+orderAmount+orderCurrency)

Payment Status List

Status List

Transaction Currency List