Check payment method setup

GET

account

payment-method-setups

{setupId}

curl --request GET \
  --url https://api.darwin.so/api/v2/account/payment-method-setups/{setupId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.darwin.so/api/v2/account/payment-method-setups/{setupId}"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.darwin.so/api/v2/account/payment-method-setups/{setupId}', 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.darwin.so/api/v2/account/payment-method-setups/{setupId}",
  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>"
  ],
]);

$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.darwin.so/api/v2/account/payment-method-setups/{setupId}"

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

	req.Header.Add("Authorization", "Bearer <token>")

	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.darwin.so/api/v2/account/payment-method-setups/{setupId}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "setup": "<string>",
  "status": "prepared",
  "revision": 4503599627370495,
  "expiresAt": "2023-11-07T05:31:56Z",
  "url": "<string>",
  "paymentMethodId": "<string>"
}

This account operation requires a user-authorized human:actions OAuth grant. It has no personal AI ID in its public path. Enrollment is bound to an immutable payment request and requires explicit save consent. The hosted provider collects card or bank details; this API never accepts them. A verified method can be listed under Account → Personal, but enrollment itself does not charge or settle the request. A standalone setup without a thread request is not available yet. This integration remains release-gated until account ownership migration and live provider verification are complete.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

setupId

string

required

Required string length: 1 - 200

Response

Authorized account metadata only.

setup

string

required

Required string length: 1 - 200

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

status

enum<string>

required

Available options:

prepared,

dispatching,

awaiting_user,

processing,

verified,

failed,

expired,

cancelled

revision

integer

required

Required range: 0 <= x <= 9007199254740991

expiresAt

string<date-time>

required

Pattern:

^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

url

string<uri>

paymentMethodId

string

Required string length: 1 - 200

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

Last modified on October 5, 2026

Check payment method setup

curl --request GET \
  --url https://api.darwin.so/api/v2/account/payment-method-setups/{setupId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.darwin.so/api/v2/account/payment-method-setups/{setupId}"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.darwin.so/api/v2/account/payment-method-setups/{setupId}', 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.darwin.so/api/v2/account/payment-method-setups/{setupId}",
  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>"
  ],
]);

$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.darwin.so/api/v2/account/payment-method-setups/{setupId}"

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

	req.Header.Add("Authorization", "Bearer <token>")

	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.darwin.so/api/v2/account/payment-method-setups/{setupId}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "setup": "<string>",
  "status": "prepared",
  "revision": 4503599627370495,
  "expiresAt": "2023-11-07T05:31:56Z",
  "url": "<string>",
  "paymentMethodId": "<string>"
}

Search

Act

Account

Check payment method setup

Authorizations

Path Parameters

Response