Update a PaymentIntent

curl --request POST \
  --url https://api-sandbox.uqpaytech.com/api/v2/payment_intents/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-auth-token: <api-key>' \
  --header 'x-client-id: <x-client-id>' \
  --header 'x-idempotency-key: <x-idempotency-key>' \
  --data '
{
  "description": "Updated contract test"
}
'

import requests

url = "https://api-sandbox.uqpaytech.com/api/v2/payment_intents/{id}"

payload = { "description": "Updated contract test" }
headers = {
    "x-idempotency-key": "<x-idempotency-key>",
    "x-client-id": "<x-client-id>",
    "x-auth-token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-idempotency-key': '<x-idempotency-key>',
    'x-client-id': '<x-client-id>',
    'x-auth-token': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({description: 'Updated contract test'})
};

fetch('https://api-sandbox.uqpaytech.com/api/v2/payment_intents/{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-sandbox.uqpaytech.com/api/v2/payment_intents/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'description' => 'Updated contract test'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-auth-token: <api-key>",
    "x-client-id: <x-client-id>",
    "x-idempotency-key: <x-idempotency-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"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sandbox.uqpaytech.com/api/v2/payment_intents/{id}"

	payload := strings.NewReader("{\n  \"description\": \"Updated contract test\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-idempotency-key", "<x-idempotency-key>")
	req.Header.Add("x-client-id", "<x-client-id>")
	req.Header.Add("x-auth-token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api-sandbox.uqpaytech.com/api/v2/payment_intents/{id}")
  .header("x-idempotency-key", "<x-idempotency-key>")
  .header("x-client-id", "<x-client-id>")
  .header("x-auth-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"description\": \"Updated contract test\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.uqpaytech.com/api/v2/payment_intents/{id}")

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

request = Net::HTTP::Post.new(url)
request["x-idempotency-key"] = '<x-idempotency-key>'
request["x-client-id"] = '<x-client-id>'
request["x-auth-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"description\": \"Updated contract test\"\n}"

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

{
  "amount": "1",
  "available_payment_method_types": null,
  "cancel_time": "",
  "cancellation_reason": "",
  "captured_amount": "0",
  "client_secret": "<client-secret>",
  "complete_time": "",
  "create_time": "2026-09-14T17:03:35+08:00",
  "currency": "SGD",
  "customer_id": "",
  "description": "Updated contract test",
  "intent_status": "REQUIRES_PAYMENT_METHOD",
  "latest_payment_attempt": null,
  "merchant_order_id": "ce37d547-53c7-4648-988b-691a352b5446",
  "metadata": null,
  "next_action": null,
  "payment_intent_id": "PI2099423807759454208",
  "return_url": "https://example.com/return",
  "update_time": "2026-09-14T17:03:36+08:00"
}

POST

payment_intents

{id}

Update a PaymentIntent

curl --request POST \
  --url https://api-sandbox.uqpaytech.com/api/v2/payment_intents/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-auth-token: <api-key>' \
  --header 'x-client-id: <x-client-id>' \
  --header 'x-idempotency-key: <x-idempotency-key>' \
  --data '
{
  "description": "Updated contract test"
}
'

import requests

url = "https://api-sandbox.uqpaytech.com/api/v2/payment_intents/{id}"

payload = { "description": "Updated contract test" }
headers = {
    "x-idempotency-key": "<x-idempotency-key>",
    "x-client-id": "<x-client-id>",
    "x-auth-token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-idempotency-key': '<x-idempotency-key>',
    'x-client-id': '<x-client-id>',
    'x-auth-token': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({description: 'Updated contract test'})
};

fetch('https://api-sandbox.uqpaytech.com/api/v2/payment_intents/{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-sandbox.uqpaytech.com/api/v2/payment_intents/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'description' => 'Updated contract test'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-auth-token: <api-key>",
    "x-client-id: <x-client-id>",
    "x-idempotency-key: <x-idempotency-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"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sandbox.uqpaytech.com/api/v2/payment_intents/{id}"

	payload := strings.NewReader("{\n  \"description\": \"Updated contract test\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-idempotency-key", "<x-idempotency-key>")
	req.Header.Add("x-client-id", "<x-client-id>")
	req.Header.Add("x-auth-token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api-sandbox.uqpaytech.com/api/v2/payment_intents/{id}")
  .header("x-idempotency-key", "<x-idempotency-key>")
  .header("x-client-id", "<x-client-id>")
  .header("x-auth-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"description\": \"Updated contract test\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.uqpaytech.com/api/v2/payment_intents/{id}")

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

request = Net::HTTP::Post.new(url)
request["x-idempotency-key"] = '<x-idempotency-key>'
request["x-client-id"] = '<x-client-id>'
request["x-auth-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"description\": \"Updated contract test\"\n}"

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

{
  "amount": "1",
  "available_payment_method_types": null,
  "cancel_time": "",
  "cancellation_reason": "",
  "captured_amount": "0",
  "client_secret": "<client-secret>",
  "complete_time": "",
  "create_time": "2026-09-14T17:03:35+08:00",
  "currency": "SGD",
  "customer_id": "",
  "description": "Updated contract test",
  "intent_status": "REQUIRES_PAYMENT_METHOD",
  "latest_payment_attempt": null,
  "merchant_order_id": "ce37d547-53c7-4648-988b-691a352b5446",
  "metadata": null,
  "next_action": null,
  "payment_intent_id": "PI2099423807759454208",
  "return_url": "https://example.com/return",
  "update_time": "2026-09-14T17:03:36+08:00"
}

Authorizations

x-auth-token

string

header

required

The API token for login provided by UQPAY.

Headers

x-on-behalf-of

string

Specifies the sub-account on whose behalf the request is made. This should be set to the account_id, which can be retrieved via the List Connected Accounts. If omitted or empty, the request is executed using the master account. More information at Connected Accounts.

x-idempotency-key

string<uuid>

required

A unique identifier (UUID) used to maintain operation idempotency, ensuring that repeated executions of the same operation do not result in unintended effects or duplication. It helps preserve data consistency in the face of network errors, retries, or failures.

x-client-id

string

required

The API client id generated by UQPAY

Path Parameters

string

required

The unique ID of a payment intent.

Example:

"PI1925112193204883441"

Body

application/json

amount

string

currency

string

Three-letter currency code

Example:

"SGD"

customer

object

Customer details pertaining to the entity executing payment for this Payment Intent shall be omitted when a customer_id parameter is specified in the request.

Show child attributes

customer_id

string

The unique identifier of the customer must be provided when the Payment Intent is designated for recurring payments. This field should be left empty in cases where the customer remains unidentified (guest checkout) or when customer information is supplied through the customer object.

payment_orders

object

Purchase order related to this PaymentIntent

Show child attributes

merchant_order_id

string

The merchant reference id created in merchant's system that corresponds to this PaymentIntent

Maximum string length: 36

description

string

Descriptor that will display to the customer. Maximum length is 32.

Maximum string length: 32

Example:

"Updated contract test"

metadata

object

Any key-value object. Max length = 512 bytes. This must be valid JSON data.

Show child attributes

Example:

{ "key1": "value1", "key2": "value2" }

return_url

string

The web page URL or application scheme URI to redirect the customer after payment authentication.

Maximum string length: 1024

Response

200 - application/json

Payment intent updated successfully

payment_intent_id

string

required

Unique identifier for the PaymentIntent

Maximum string length: 36

Example:

"b1c2d3e4-f5a6-b7c8-d9e0-f1a2b3c4d5e6"

amount

string

required

Payment amount. This is the order amount you would like to charge your customer.

Example:

"10.12"

currency

string

required

Three-letter currency code

Example:

"SGD"

intent_status

enum<string>

required

Status of this PaymentIntent.

REQUIRES_PAYMENT_METHOD: The PaymentIntent is waiting for the confirm request.
REQUIRES_CUSTOMER_ACTION: The PaymentIntent is waiting for further customer action of authentication, e.g. 3DS verification and QR code scan. Please check the next_action.
REQUIRES_CAPTURE: The PaymentIntent is waiting for your capture to complete the payment.
PENDING: The PaymentIntent is pending the final result from the provider. No further action is required.
SUCCEEDED: The PaymentIntent has succeeded. The payment is complete.
CANCELLED: The PaymentIntent has been canceled by your request. The payment is closed.
FAILED: The PaymentIntent has failed.
PARTIALLY_CAPTURED: A partially captured authorization has an outstanding balance; do not submit another capture.
EXPIRED: The pre-authorization expired and was released.

Available options:

PARTIALLY_CAPTURED,

EXPIRED,

REQUIRES_PAYMENT_METHOD,

REQUIRES_CUSTOMER_ACTION,

REQUIRES_CAPTURE,

PENDING,

SUCCEEDED,

CANCELLED,

FAILED

Example:

"SUCCEEDED"

current_funds_action

object

Refund or authorization-release details, when available in Retrieve or List PaymentIntents.

capture_records

object[]

Capture records returned by Retrieve and List PaymentIntents.

Show child attributes

authorization_type

enum<string>

Authorization mode for this payment.

Available options:

authorization,

pre_authorization

authorization_expires_at

string<date-time> | null

Pre-authorization expiry. Null when no expiry is recorded. Use the returned time rather than a fixed holding period.

available_to_capture

string

Remaining pre-authorized amount available for capture. A final capture consumes the available authorization; inspect capture_records for channel processing results.

available_to_void

string

Remaining pre-authorized amount, equal to available_to_capture. A positive value alone does not mean cancellation is permitted.

description

string

Descriptor while creating a PaymentIntent.

Maximum string length: 255

available_payment_method_types

string[] | null

Available payment method types for this PaymentIntent.

captured_amount

string

Aggregate capture amount recorded on the PaymentIntent. Capture acceptance can update this value before channel completion; check capture_records for processing results.

Example:

"10.12"

customer

object

Snapshot of the customer associated with this PaymentIntent. Returned when customer or customer_id was supplied at creation time. The customer's unique identifier is exposed at the top level as customer_id; the id field is not included inside this object.

Show child attributes

customer_id

string

ID of the customer associated with this PaymentIntent. Empty for guest checkout.

Maximum string length: 36

Example:

"cus_asyknf3wlfxhs1s6plamk80i8v"

cancel_time

Cancellation timestamp; an empty string when no cancellation time is recorded.

cancellation_reason

string

Reason for canceling this PaymentIntent.

Example:

"Order cancelled"

client_secret

string

PaymentIntent's client secret for browser or app. Returned by PaymentIntent create API or PaymentIntent retrieve API. The provided client_secret is valid for 60 minutes.

Example:

"eyJhbGciOiJI***********ujNdZ1DF9CqWEfF1jphxI"

merchant_order_id

string

The merchant reference id created in merchant's system that corresponds to this PaymentIntent

Maximum string length: 36

Example:

"1bf70d90-9ed0-48ce-9370-9bd7ef6ab9ee"

metadata

object | null

Metadata associated with the payment. Returns null when no metadata is set.

Show child attributes

next_action

object | null

Null when no next action is available; otherwise follow the returned action instructions.

Show child attributes

return_url

string

The web page URL or application scheme URI to redirect the customer after payment authentication.

Example:

"https://127.0.0.1:8080/api/v1/callback"

create_time

string<date/time>

Time at which this PaymentIntent was created.

Example:

"2024-03-01T00:00:00+08:00"

complete_time

Completion timestamp; an empty string when no completion time is recorded.

update_time

string<date/time>

Last time at which this PaymentIntent was updated or operated on.

Example:

"2024-03-01T00:00:00+08:00"

latest_payment_attempt

Latest payment attempt · object

Latest PaymentAttempt; null when no payment attempt is available.

Latest payment attempt
No payment attempt

Show child attributes