Skip to main content
GET
/
api
/
v1
/
payment_method
/
{payment_method_id}
{
  "id": "<string>",
  "customer_id": "<string>",
  "merchant_id": "<string>",
  "type": "<string>",
  "address": "<string>",
  "created_at": 123,
  "updated_at": 123,
  "metadata": {}
}

Authorizations

​
Authorization
string
header
required

Bearer API Key, for example Bearer sk_live_xxx.

​
X-StablePay-Timestamp
string
header
required

Unix timestamp in seconds. Must be within 5 minutes of server time.

​
X-StablePay-Nonce
string
header
required

Replay-protection nonce, 16-64 characters. Use a fresh UUID per request.

​
X-StablePay-Signature
string
header
required

Lowercase hex HMAC-SHA256 of {timestamp}.{nonce}.{requestBody} signed with the merchant API Secret. For GET requests, requestBody is an empty string.

Headers

​
X-StablePay-Timestamp
string
required

Unix timestamp in seconds. Must be within 5 minutes of server time.

​
X-StablePay-Nonce
string
required

Replay-protection nonce, 16-64 characters. Use a fresh UUID per request.

Required string length: 16 - 64
​
X-StablePay-Signature
string
required

Lowercase hex HMAC-SHA256 of {timestamp}.{nonce}.{requestBody} signed with the merchant API Secret. For GET requests, requestBody is an empty string.

Path Parameters

​
payment_method_id
string
required

Payment method ID.

Response

Retrieved successfully.

​
id
string
required

Payment method ID.

​
customer_id
string
required

Customer ID.

​
merchant_id
string
required

Merchant ID.

​
type
string
required

Payment method type, currently usually crypto.

​
address
string
required

Payment address. The current implementation returns an empty string.

​
status
enum<string>
required

Payment method status.

Available options:
active,
inactive,
revoked,
unknown
​
created_at
integer<int64>
required

Creation time, Unix seconds.

​
updated_at
integer<int64>
required

Update time, Unix seconds.

​
metadata
object

Payment method metadata.

Last modified on April 30, 2026