Validate a transaction

Endpoint for validating transaction results

Request Syntax

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

Proceed via the TID used in the payment request

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

Request

Name	Data Type	Description
client_id	String(12)	Merchant ID
tid	String(24)	ID received in response to a payment preparation request
partner_order_id	String(100)	Internal payment unique key to prevent duplicate payments
partner_user_id	String(100)	Internal username for managing payment history

Response

Name	Data Type	Description
tid	String(24)	A unique identifier for the payment
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)	Payment asset symbols
amount	String(24)	Payment amount string
create_at	Int	Payment request time
validate_at	Int	Payment authorization time

Sample

CURL

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

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',
    partner_order_id: 'YOUR_PARTNER_ORDER_ID',
    partner_user_id: 'YOUR_PARTNER_USER_ID'
};

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

axios.post('https://api.excoinz.com/payment/validate', requestData, config)
    .then(response => {
        console.log(response.data);
    })
    .catch(error => {
        console.error('Error:', error);
    });

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/validate";
    private static final String SECRET_KEY = "YOUR_SECRET_KEY";
    private static final String ACCESS_TOKEN = "YOUR_ACCESS_TOKEN";

    public ResponseEntity<String> validatePayment() {
        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");
        body.put("partner_order_id", "YOUR_PARTNER_ORDER_ID");
        body.put("partner_user_id", "YOUR_PARTNER_USER_ID");

        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/validate';

$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",
    "partner_order_id" => "YOUR_PARTNER_ORDER_ID",
    "partner_user_id" => "YOUR_PARTNER_USER_ID"
);

$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;

?>