Check Transaction Status by Reference

curl --request GET \
  --url https://api.dompetx.com/v1/payments/check-status \
  --header 'X-DOMPAY-API-Key: <api-key>' \
  --header 'X-DOMPAY-Signature: <api-key>' \
  --header 'X-DOMPAY-Timestamp: <api-key>'

import requests

url = "https://api.dompetx.com/v1/payments/check-status"

headers = {
    "X-DOMPAY-API-Key": "<api-key>",
    "X-DOMPAY-Signature": "<api-key>",
    "X-DOMPAY-Timestamp": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {
    'X-DOMPAY-API-Key': '<api-key>',
    'X-DOMPAY-Signature': '<api-key>',
    'X-DOMPAY-Timestamp': '<api-key>'
  }
};

fetch('https://api.dompetx.com/v1/payments/check-status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dompetx.com/v1/payments/check-status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-DOMPAY-API-Key: <api-key>",
    "X-DOMPAY-Signature: <api-key>",
    "X-DOMPAY-Timestamp: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dompetx.com/v1/payments/check-status"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-DOMPAY-API-Key", "<api-key>")
	req.Header.Add("X-DOMPAY-Signature", "<api-key>")
	req.Header.Add("X-DOMPAY-Timestamp", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.dompetx.com/v1/payments/check-status")
  .header("X-DOMPAY-API-Key", "<api-key>")
  .header("X-DOMPAY-Signature", "<api-key>")
  .header("X-DOMPAY-Timestamp", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dompetx.com/v1/payments/check-status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-DOMPAY-API-Key"] = '<api-key>'
request["X-DOMPAY-Signature"] = '<api-key>'
request["X-DOMPAY-Timestamp"] = '<api-key>'

response = http.request(request)
puts response.read_body

GET

payments

check-status

Check Transaction Status by Reference

curl --request GET \
  --url https://api.dompetx.com/v1/payments/check-status \
  --header 'X-DOMPAY-API-Key: <api-key>' \
  --header 'X-DOMPAY-Signature: <api-key>' \
  --header 'X-DOMPAY-Timestamp: <api-key>'

import requests

url = "https://api.dompetx.com/v1/payments/check-status"

headers = {
    "X-DOMPAY-API-Key": "<api-key>",
    "X-DOMPAY-Signature": "<api-key>",
    "X-DOMPAY-Timestamp": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {
    'X-DOMPAY-API-Key': '<api-key>',
    'X-DOMPAY-Signature': '<api-key>',
    'X-DOMPAY-Timestamp': '<api-key>'
  }
};

fetch('https://api.dompetx.com/v1/payments/check-status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dompetx.com/v1/payments/check-status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-DOMPAY-API-Key: <api-key>",
    "X-DOMPAY-Signature: <api-key>",
    "X-DOMPAY-Timestamp: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dompetx.com/v1/payments/check-status"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-DOMPAY-API-Key", "<api-key>")
	req.Header.Add("X-DOMPAY-Signature", "<api-key>")
	req.Header.Add("X-DOMPAY-Timestamp", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.dompetx.com/v1/payments/check-status")
  .header("X-DOMPAY-API-Key", "<api-key>")
  .header("X-DOMPAY-Signature", "<api-key>")
  .header("X-DOMPAY-Timestamp", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dompetx.com/v1/payments/check-status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-DOMPAY-API-Key"] = '<api-key>'
request["X-DOMPAY-Signature"] = '<api-key>'
request["X-DOMPAY-Timestamp"] = '<api-key>'

response = http.request(request)
puts response.read_body

Overview

Check the latest payment status using the merchant reference supplied when the transaction was created. The reference lookup is scoped to the merchant identified by the API key. References belonging to another merchant are not accessible and return 404.

Request Example

GET /v1/payments/check-status?reference=ORDER-20260714-001
X-DOMPAY-API-Key: dp_****************************ABCD
X-DOMPAY-Timestamp: 1783987200
X-DOMPAY-Signature: {request_signature}

Response Example

{
  "id": "dbd245ac-421d-4e79-ba1a-4a0f90d75dae",
  "reference": "ORDER-20260714-001",
  "status": "paid",
  "amount": 50000,
  "currency": "IDR",
  "type": "qr_dynamic",
  "history": null
}

This endpoint contacts the payment provider and may update the status stored by DompetX. Use the transaction detail endpoint when only the currently stored data is needed.

Authorizations

X-DOMPAY-API-Key

string

header

required

X-DOMPAY-Signature

string

header

required

X-DOMPAY-Timestamp

string

header

required

Query Parameters

reference

string

required

Merchant transaction reference supplied when the payment was created.

Example:

"ORDER-20260714-001"

Response

Status retrieved successfully

Check Transaction Status Cancel Transaction

​Overview

​Request Example

​Response Example

Authorizations

Query Parameters

Response

Overview

Request Example

Response Example