customer-payment-methods

Last used alternate payment details

The customer details this customer last supplied for each alternate payment method, keyed by the payment method type reported in a cart’s available_payment_methods (for example mpesa_dlocal). Checkout seeds an auto-selected method’s required fields with these so a returning customer is not asked for them again.

Values are limited to the fields the integration declares and to the authenticated customer’s own records. These are identity documents, so they are served here rather than on the cart, which is readable by cart token alone. Returns an empty object when nothing is stored, and 401 when unauthenticated.

GET

api

checkout

v2026-04

customers

payment_methods

customer_details

Last used alternate payment details

curl --request GET \
  --url https://api.fluid.app/api/checkout/v2026-04/customers/me/payment_methods/customer_details \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.fluid.app/api/checkout/v2026-04/customers/me/payment_methods/customer_details"

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

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

print(response.text)

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

fetch('https://api.fluid.app/api/checkout/v2026-04/customers/me/payment_methods/customer_details', 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.fluid.app/api/checkout/v2026-04/customers/me/payment_methods/customer_details",
  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.fluid.app/api/checkout/v2026-04/customers/me/payment_methods/customer_details"

	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.fluid.app/api/checkout/v2026-04/customers/me/payment_methods/customer_details")

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

{
  "customer_details": {},
  "status": 123,
  "meta": {
    "request_uuid": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer token authentication

Response

Success

customer_details

object

required

Stored details keyed by payment method type, matching a cart's available_payment_methods[].type (for example mpesa_dlocal). Each value holds the fields that method declares, such as phone and document_id. Empty when the customer has stored none.

Show child attributes

status

integer

required

meta

object

required

Show child attributes

Last used alternate payment details

curl --request GET \
  --url https://api.fluid.app/api/checkout/v2026-04/customers/me/payment_methods/customer_details \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.fluid.app/api/checkout/v2026-04/customers/me/payment_methods/customer_details"

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

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

print(response.text)

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

fetch('https://api.fluid.app/api/checkout/v2026-04/customers/me/payment_methods/customer_details', 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.fluid.app/api/checkout/v2026-04/customers/me/payment_methods/customer_details",
  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.fluid.app/api/checkout/v2026-04/customers/me/payment_methods/customer_details"

	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.fluid.app/api/checkout/v2026-04/customers/me/payment_methods/customer_details")

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

{
  "customer_details": {},
  "status": 123,
  "meta": {
    "request_uuid": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>"
}

Overview

Task guides

Portal & Widgets

Endpoints

Auth endpoints

Checkout endpoints

Public SDK endpoints

Payment gateway endpoints

Cart payment endpoints

Commerce endpoints

Webhooks endpoints

Company admin endpoints (v0)

Analytics

Last used alternate payment details

Authorizations

Response