List account-bound payment methods

List my account-bound Payment methods

curl --request GET \
  --url https://prod-api.stableyard.fi/v2/client/me/payments/{paymentId}/payment-methods \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Stableyard-Payment-Secret: <api-key>'

import requests

url = "https://prod-api.stableyard.fi/v2/client/me/payments/{paymentId}/payment-methods"

headers = {
    "Authorization": "Bearer <token>",
    "X-Stableyard-Payment-Secret": "<api-key>"
}

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

print(response.text)

const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'X-Stableyard-Payment-Secret': '<api-key>'}
};

fetch('https://prod-api.stableyard.fi/v2/client/me/payments/{paymentId}/payment-methods', 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://prod-api.stableyard.fi/v2/client/me/payments/{paymentId}/payment-methods",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "X-Stableyard-Payment-Secret: <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://prod-api.stableyard.fi/v2/client/me/payments/{paymentId}/payment-methods"

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-Stableyard-Payment-Secret", "<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://prod-api.stableyard.fi/v2/client/me/payments/{paymentId}/payment-methods")
  .header("Authorization", "Bearer <token>")
  .header("X-Stableyard-Payment-Secret", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://prod-api.stableyard.fi/v2/client/me/payments/{paymentId}/payment-methods")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
request["X-Stableyard-Payment-Secret"] = '<api-key>'

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

{
  "paymentMethods": [
    {
      "id": "vault.stableyard",
      "providerCode": "vault",
      "type": "vault",
      "displayName": "Pay with Stableyard Vault",
      "networkCode": "arbitrum",
      "chainId": 42161,
      "tokenAddress": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "assetSymbol": "USDC",
      "decimals": 6,
      "available": true,
      "availability": "ready",
      "recommended": true,
      "disabledReason": null,
      "estimatedSeconds": null,
      "minimumAmount": null,
      "minimumAmountSource": "provider",
      "maximumAmount": null,
      "executionTypes": [
        "managed_authorization"
      ],
      "walletFamily": "evm",
      "requiresAccountContext": true
    }
  ]
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid",
    "details": "example"
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid",
    "details": "example"
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid",
    "details": "example"
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid",
    "details": "example"
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid",
    "details": "example"
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid",
    "details": "example"
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid",
    "details": "example"
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid",
    "details": "example"
  }
}

GET

client

payments

{paymentId}

payment-methods

List my account-bound Payment methods

curl --request GET \
  --url https://prod-api.stableyard.fi/v2/client/me/payments/{paymentId}/payment-methods \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Stableyard-Payment-Secret: <api-key>'

import requests

url = "https://prod-api.stableyard.fi/v2/client/me/payments/{paymentId}/payment-methods"

headers = {
    "Authorization": "Bearer <token>",
    "X-Stableyard-Payment-Secret": "<api-key>"
}

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

print(response.text)

const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'X-Stableyard-Payment-Secret': '<api-key>'}
};

fetch('https://prod-api.stableyard.fi/v2/client/me/payments/{paymentId}/payment-methods', 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://prod-api.stableyard.fi/v2/client/me/payments/{paymentId}/payment-methods",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "X-Stableyard-Payment-Secret: <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://prod-api.stableyard.fi/v2/client/me/payments/{paymentId}/payment-methods"

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-Stableyard-Payment-Secret", "<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://prod-api.stableyard.fi/v2/client/me/payments/{paymentId}/payment-methods")
  .header("Authorization", "Bearer <token>")
  .header("X-Stableyard-Payment-Secret", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://prod-api.stableyard.fi/v2/client/me/payments/{paymentId}/payment-methods")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
request["X-Stableyard-Payment-Secret"] = '<api-key>'

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

{
  "paymentMethods": [
    {
      "id": "vault.stableyard",
      "providerCode": "vault",
      "type": "vault",
      "displayName": "Pay with Stableyard Vault",
      "networkCode": "arbitrum",
      "chainId": 42161,
      "tokenAddress": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "assetSymbol": "USDC",
      "decimals": 6,
      "available": true,
      "availability": "ready",
      "recommended": true,
      "disabledReason": null,
      "estimatedSeconds": null,
      "minimumAmount": null,
      "minimumAmountSource": "provider",
      "maximumAmount": null,
      "executionTypes": [
        "managed_authorization"
      ],
      "walletFamily": "evm",
      "requiresAccountContext": true
    }
  ]
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid",
    "details": "example"
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid",
    "details": "example"
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid",
    "details": "example"
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid",
    "details": "example"
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid",
    "details": "example"
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid",
    "details": "example"
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid",
    "details": "example"
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid",
    "details": "example"
  }
}

Returns additional account-bound methods for this receive Payment and the UPA fixed by the client bearer token. This catalog is separate from public checkout, which stays limited to Direct crypto, Routing and entitled hosted on-ramp methods. Vault is returned only when the client token has both Payments and Vault access, this UPA can pay the Payment, and the UPA has an active Vault payment source whose chain, token and amount can satisfy the Payment’s immutable escrow obligation exactly. Send both the client bearer token and the Payment-specific X-Stableyard-Payment-Secret; neither credential is sufficient on its own.

Authorizations

Authorization

string

header

required

Short-lived account-bound token returned by POST /v2/client/auth/exchange.

X-Stableyard-Payment-Secret

string

header

required

Payment-specific secret used together with an account-bound Client bearer token. It proves access to exactly one Payment and must never be placed in a URL, analytics event, or log.

Path Parameters

paymentId

string

required

Canonical receive Payment whose escrow will be funded.

Pattern: ^payment_[A-Za-z0-9_-]+$

Example:

"payment_123"

Response

Account-bound methods available to this UPA

paymentMethods

object[]

required

Contains vault.stableyard when the token-bound UPA has an eligible active Vault Payment Source; otherwise the request fails closed.

Maximum array length: 1

Show child attributes

Introduction

Onboarding

Accounts

Money movement

Activity

Vaults

Client & checkout

Platform

List account-bound payment methods

Authorizations

Path Parameters

Response