User transaction info

Endpoints for fetching user transaction info

Request Syntax

POST /payment/info HTTP/1.1
Host: api.excoinz.com
EXCOINZ_SECRET: ${SECRET_KEY}
Authorization: Bearer ${ACCESS_TOKEN}
Content-Type: application/json

You can only view transactions from that merchant.

Setting the AccessToken Header is required.

• All requests must be made from the registered server/domain.

• If you need an id/secret for testing, please contact [e-mail]

Request

Name	Data Type	Description
client_id	String(12)	Merchant ID
tid	String(24)	A unique identifier for the payment

Response

Name	Data Type	Description
tid	String(24)	A unique identifier for the payment
status	String	Progress of the current transaction READY INITIATED COMPLETED CANCELLED EXPIRED
partner_order_id	String(100)	Internal payment unique key to prevent duplicate payments
partner_user_id	String(100)	Internal username for managing payment history
asset_symbol	String(10)	Symbol of the cryptocurrency to be paid
amount	String(24)	Total amount of tokens to pay string
create_at	Int	Payment request time
validate_at	Int	Payment authorization time

Sample

CURL

curl -X POST https://api.excoinz.com/payment/order \
     -H "EXCOINZ_SECRET: ${SECRET_KEY}" \
     -H "Authorization: Bearer ${ACCESS_TOKEN}" \
     -H "Content-Type: application/json" \
     -d '{
         "client_id": "YOUR_CLIENT_ID",
         "tid": "YOUR_TID"
     }'

Node.js

const axios = require('axios');

const SECRET_KEY = 'YOUR_SECRET_KEY';
const ACCESS_TOKEN = 'YOUR_ACCESS_TOKEN';

const requestData = {
    client_id: 'YOUR_CLIENT_ID',
    tid: 'YOUR_TID'
};

const config = {
    headers: {
        'EXCOINZ_SECRET': SECRET_KEY,
        'Authorization': `Bearer ${ACCESS_TOKEN}`,
        'Content-Type': 'application/json'
    }
};

axios.post('https://api.excoinz.com/payment/order', requestData, config)
    .then(response => {
        console.log(response.data);
    })
    .catch(error => {
        if (error.response) {
            console.error('Response data:', error.response.data);
            console.error('Response status:', error.response.status);
        } else if (error.request) {
            console.error('No response received:', error.request);
        } else {
            console.error('Axios error:', error.message);
        }
    });

JAVA

import org.springframework.http.*;
import org.springframework.stereotype.Service;
import org.springframework.web.client.RestTemplate;
import java.util.HashMap;
import java.util.Map;

@Service
public class ExcoinzService {

    private static final String ENDPOINT_URL = "https://api.excoinz.com/payment/order";
    private static final String SECRET_KEY = "YOUR_SECRET_KEY";
    private static final String ACCESS_TOKEN = "YOUR_ACCESS_TOKEN";

    public ResponseEntity<String> orderPayment() {
        RestTemplate restTemplate = new RestTemplate();

        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_JSON);
        headers.set("EXCOINZ_SECRET", SECRET_KEY);
        headers.setBearerAuth(ACCESS_TOKEN);

        Map<String, String> body = new HashMap<>();
        body.put("client_id", "YOUR_CLIENT_ID");
        body.put("tid", "YOUR_TID");

        HttpEntity<Map<String, String>> entity = new HttpEntity<>(body, headers);

        ResponseEntity<String> response = restTemplate.exchange(ENDPOINT_URL, HttpMethod.POST, entity, String.class);

        return response;
    }
}

PHP

<?php

$url = 'https://api.excoinz.com/payment/order';

$SECRET_KEY = 'YOUR_SECRET_KEY';
$ACCESS_TOKEN = 'YOUR_ACCESS_TOKEN';

$headers = array(
    "EXCOINZ_SECRET: $SECRET_KEY",
    "Authorization: Bearer $ACCESS_TOKEN",
    "Content-Type: application/json"
);

$data = array(
    "client_id" => "YOUR_CLIENT_ID",
    "tid" => "YOUR_TID"
);

$ch = curl_init($url);

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);

if ($error = curl_error($ch)) {
    die('cURL error: ' . $error);
}

curl_close($ch);

echo $response;

?>