Zennopay Docs — QR Payments and Platform Payouts

GET

payment_intents

{intent_id}

Get payment intent

curl --request GET \
  --url https://api.example.com/v1/payment_intents/{intent_id}

const options = {method: 'GET'};

fetch('https://api.example.com/v1/payment_intents/{intent_id}', 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.example.com/v1/payment_intents/{intent_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$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.example.com/v1/payment_intents/{intent_id}"

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

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/v1/payment_intents/{intent_id}")

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

request = Net::HTTP::Get.new(url)

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

Authenticate with either partner HMAC or a session bearer token bound to this intent. The bearer-token projection contains only SDK-safe fields; the HMAC projection contains the complete partner record. Bearer status reads verify but do not consume the token jti.

Bearer/SDK response

{
  "id": "0198f31a-7c2b-7d91-9fa2-112233445566",
  "reconciliation_ref": "zpr_...",
  "status": "authorized",
  "amount_usd_cents": 345,
  "corridor": "vn_vietqr",
  "created_at": "2026-09-02T12:00:00.000Z",
  "updated_at": "2026-09-02T12:00:03.000Z"
}

Payment lifecycle

Status	Meaning	Next action
`created`	Intent exists; payment is not yet confirmed.	Present PaymentSheet.
`authorized`	Wallet execution or merchant delivery is in progress or under recovery.	Continue tracking the existing intent.
`captured`	Merchant delivery succeeded.	Reconcile the completed payment.
`failed`	Payment reached a final failure.	Reconcile the failure.
`expired`	Intent expired without completion.	End this checkout attempt.
`refunded`	Payment was refunded.	Reconcile the returned funds.
`reversed`	Delivery was reversed.	Reconcile the reversal.

created and authorized are non-terminal. A captured payment may later be refunded or reversed, so continue processing subsequent events. An SDK pending result is a client outcome; the stored intent keeps its API status.

Partner/HMAC response

The HMAC response adds partner identifiers, QR/merchant and quote state, execution references, confirm state, timestamps, and other reconciliation fields. Every BIGINT-denominated local amount is serialized as a decimal int64 string, including:

provider_local_amount_minor_units
qr_amount_minor_units
quote_local_amount_minor_units

Fields with no value are null. Cross-partner access is rejected. Use Reconciliation for recovery guidance and QR Payments webhooks for signed status events.

⌘I

Get payment intent

curl --request GET \
  --url https://api.example.com/v1/payment_intents/{intent_id}

const options = {method: 'GET'};

fetch('https://api.example.com/v1/payment_intents/{intent_id}', 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.example.com/v1/payment_intents/{intent_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$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.example.com/v1/payment_intents/{intent_id}"

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

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/v1/payment_intents/{intent_id}")

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

request = Net::HTTP::Get.new(url)

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

Get started

Guides

QR Payments

Platform Payouts

API reference

Resources

Get payment intent

Bearer/SDK response

Payment lifecycle

Partner/HMAC response

​Bearer/SDK response

​Payment lifecycle

​Partner/HMAC response

Bearer/SDK response

Payment lifecycle

Partner/HMAC response