Get Payment Method

curl --request GET \
  --url https://api.prod.finverse.net/payment_methods/{paymentMethodId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.prod.finverse.net/payment_methods/{paymentMethodId}"

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

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

print(response.text)

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

fetch('https://api.prod.finverse.net/payment_methods/{paymentMethodId}', 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.prod.finverse.net/payment_methods/{paymentMethodId}",
  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.prod.finverse.net/payment_methods/{paymentMethodId}"

	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.prod.finverse.net/payment_methods/{paymentMethodId}")

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

{
  "card": {
    "card_details": {
      "acquirer_authorization_reference": "R7RRPSMPR5P",
      "brand": "Visa",
      "brand_product_name": "visa",
      "card_number_alias": "F495225511395777",
      "collection_entity_name": "Demo Company Limited",
      "country": "NL",
      "expiry_month": 3,
      "expiry_year": 2030,
      "fingerprint": "5ePOmfH7G5irogopQi8b1XfF4G3CF",
      "finverse_authorization_reference": "FC260415XP40",
      "last4": "1111",
      "processor_details": {
        "auth_code": "070240",
        "processor_id": "ADYEN",
        "processor_reference": "PTQK3MZ7F9SRCTV5",
        "token_id": "WV947F3N9PJ3JWV5"
      },
      "recurring_payment_mode": "NON_RECURRING"
    },
    "created_at": "2026-04-15T07:39:00.921Z",
    "recipient_account": {
      "account_id": "01K3NA2VWQCX4GKKTRH5RQRGQ2",
      "account_type": "SETTLEMENT_ACCOUNT"
    },
    "risk_data": {
      "processor_risk_data": {
        "browser_type": "Chrome",
        "device_type": "Other",
        "shopper_country": "HK",
        "shopper_ip": "121.202.204.206",
        "shopper_locale": "en-US"
      }
    },
    "status": "SUCCEEDED",
    "updated_at": "2026-04-15T07:39:37.032Z"
  },
  "integration_metadata": {
    "adyen_metadata": {
      "auth_code": "070240",
      "payment_method_id": "WV947F3N9PJ3JWV5",
      "psp_reference": "PTQK3MZ7F9SRCTV5",
      "recurring_processing_model": "UnscheduledCardOnFile"
    },
    "integration_id": "ADYEN"
  },
  "payment_method_id": "01KP818HDB4CVFQEXNCV7AMNH3",
  "payment_method_type": "CARD"
}

Payment methods

Get Payment Method

Retrieve a single Payment Method (using a specific payment_method_id).

Authorization: customer_token

Limitations: Payment Methods are only returned for payment methods that are stored. The following payment methods are not stored:

One-time payment methods (e.g. manual bank transfer via FPS/PayNow);
Some card payment methods authorized for only one-time use (depending on the external payment gateway).
1. For these one-time card payments, some card details may be included directly in the Payments object (see payments.payment_methods), if available from the external payment gateway.

Response fields

Single Payment Method object.

GET

payment_methods

{paymentMethodId}

Get Payment Method

curl --request GET \
  --url https://api.prod.finverse.net/payment_methods/{paymentMethodId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.prod.finverse.net/payment_methods/{paymentMethodId}"

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

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

print(response.text)

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

fetch('https://api.prod.finverse.net/payment_methods/{paymentMethodId}', 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.prod.finverse.net/payment_methods/{paymentMethodId}",
  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.prod.finverse.net/payment_methods/{paymentMethodId}"

	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.prod.finverse.net/payment_methods/{paymentMethodId}")

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

{
  "card": {
    "card_details": {
      "acquirer_authorization_reference": "R7RRPSMPR5P",
      "brand": "Visa",
      "brand_product_name": "visa",
      "card_number_alias": "F495225511395777",
      "collection_entity_name": "Demo Company Limited",
      "country": "NL",
      "expiry_month": 3,
      "expiry_year": 2030,
      "fingerprint": "5ePOmfH7G5irogopQi8b1XfF4G3CF",
      "finverse_authorization_reference": "FC260415XP40",
      "last4": "1111",
      "processor_details": {
        "auth_code": "070240",
        "processor_id": "ADYEN",
        "processor_reference": "PTQK3MZ7F9SRCTV5",
        "token_id": "WV947F3N9PJ3JWV5"
      },
      "recurring_payment_mode": "NON_RECURRING"
    },
    "created_at": "2026-04-15T07:39:00.921Z",
    "recipient_account": {
      "account_id": "01K3NA2VWQCX4GKKTRH5RQRGQ2",
      "account_type": "SETTLEMENT_ACCOUNT"
    },
    "risk_data": {
      "processor_risk_data": {
        "browser_type": "Chrome",
        "device_type": "Other",
        "shopper_country": "HK",
        "shopper_ip": "121.202.204.206",
        "shopper_locale": "en-US"
      }
    },
    "status": "SUCCEEDED",
    "updated_at": "2026-04-15T07:39:37.032Z"
  },
  "integration_metadata": {
    "adyen_metadata": {
      "auth_code": "070240",
      "payment_method_id": "WV947F3N9PJ3JWV5",
      "psp_reference": "PTQK3MZ7F9SRCTV5",
      "recurring_processing_model": "UnscheduledCardOnFile"
    },
    "integration_id": "ADYEN"
  },
  "payment_method_id": "01KP818HDB4CVFQEXNCV7AMNH3",
  "payment_method_type": "CARD"
}

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

paymentMethodId

string

required

Response

Success (Card)

card

object

Card object Included only if payment_method_type = CARD.

Show child attributes

integration_metadata

object

Show child attributes

mandate

object

Mandate object. Refer to Mandate object data model in GET /mandates/{mandate_id}. Included only if payment_method_type = MANDATE.

Show child attributes

payment_method_id

string

Finverse unique ID for this payment method. If the Sender has autopay_consent = true , this ID can be used to trigger additional payments on-demand (see POST /payments).

payment_method_type

string

Type of payment method. Possible values: CARD, MANDATE.