Receive Payment

This endpoint is useful for generating unique payment URLs. You can use this to accept payments from anyone registered with ZexPay.io.

Parameters

Sample Codes

PHPExample
<?php
  $api_key = 'YOUR_MERCHANT_API_KEY';
  $url = 'https://zexpay.io/api/v1/merchant/';
  $data = [
    "item_desc"    => 'Bill #15',
    "amount"       => 815,
    "crypto_1"     => 'USDT',
    "crypto_2"     => 'BTC',
    "custom_id"    => 15,
    "webhook_url"  => 'https://mycrypto.store/pay/webhook/',
    "paid_url"     => 'https://mycrypto.store/pay/paid/',
    "cancel_url"   => 'https://mycrypto.store/pay/cancel/'
  ];
  $e_data = json_encode($data);

  $ch = curl_init($url);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
  curl_setopt($ch, CURLOPT_POSTFIELDS, $e_data);
  curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'api-key: '.$api_key
  ]);
  curl_setopt($ch, CURLOPT_TIMEOUT, 10);
  $response = curl_exec($ch);
  $result = json_decode($response, true);
  var_dump($result);
?>

These example code snippets demonstrate how to request the "Receive Payment" endpoint using PHP cURL. You can customize the data parameters according to your specific requirements. And below is the response you will receive:

JSONSuccess Response
{
  "status"  : 200,
  "error"   : false,
  "message" : "ok",
  "data"    : {
      "pay_url" : "https://zexpay.io/merchant/?pay=UNIQUE_PAYMENT_CODE"
  }
}

Statuses

Below is a list of status from this endpoint. This can be a validation material for your website:

JSONError Response
{
  "status"  : 405,
  "error"   : true,
  "message" : "Merchant not recognized.",
  "data"    : null
}