Save customer details

curl --request POST \
  --url https://api.tribridge.xyz/payments/checkout/{id}/customer \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "email": "jane@example.com",
  "name": "Jane Doe"
}
'

import requests

url = "https://api.tribridge.xyz/payments/checkout/{id}/customer"

payload = {
    "email": "jane@example.com",
    "name": "Jane Doe"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({email: 'jane@example.com', name: 'Jane Doe'})
};

fetch('https://api.tribridge.xyz/payments/checkout/{id}/customer', 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.tribridge.xyz/payments/checkout/{id}/customer",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'email' => 'jane@example.com',
    'name' => 'Jane Doe'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <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"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tribridge.xyz/payments/checkout/{id}/customer"

	payload := strings.NewReader("{\n  \"email\": \"jane@example.com\",\n  \"name\": \"Jane Doe\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.tribridge.xyz/payments/checkout/{id}/customer")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"email\": \"jane@example.com\",\n  \"name\": \"Jane Doe\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tribridge.xyz/payments/checkout/{id}/customer")

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

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"email\": \"jane@example.com\",\n  \"name\": \"Jane Doe\"\n}"

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

{
  "ok": true
}

{
  "error": "A valid email address is required"
}

{
  "error": "Payment is not accepting contact details"
}

POST

payments

checkout

{id}

customer

Save customer details

curl --request POST \
  --url https://api.tribridge.xyz/payments/checkout/{id}/customer \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "email": "jane@example.com",
  "name": "Jane Doe"
}
'

import requests

url = "https://api.tribridge.xyz/payments/checkout/{id}/customer"

payload = {
    "email": "jane@example.com",
    "name": "Jane Doe"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({email: 'jane@example.com', name: 'Jane Doe'})
};

fetch('https://api.tribridge.xyz/payments/checkout/{id}/customer', 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.tribridge.xyz/payments/checkout/{id}/customer",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'email' => 'jane@example.com',
    'name' => 'Jane Doe'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <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"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tribridge.xyz/payments/checkout/{id}/customer"

	payload := strings.NewReader("{\n  \"email\": \"jane@example.com\",\n  \"name\": \"Jane Doe\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.tribridge.xyz/payments/checkout/{id}/customer")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"email\": \"jane@example.com\",\n  \"name\": \"Jane Doe\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tribridge.xyz/payments/checkout/{id}/customer")

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

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"email\": \"jane@example.com\",\n  \"name\": \"Jane Doe\"\n}"

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

{
  "ok": true
}

{
  "error": "A valid email address is required"
}

{
  "error": "Payment is not accepting contact details"
}

Stores the payer’s contact email (and optional name) on a pending payment. The moment the payment completes, Tribridge emails that address a payment receipt. No API key required — call it from your own checkout UI (it runs in the customer’s browser context or your backend) while collecting contact details.

Rules

Accepted only while the payment is pending. Once it moves on you get 409 — Payment is not accepting contact details.
Idempotent — safe to re-post on retries with the same payload.
Email must be a valid address (max 254 chars); name is trimmed to 120 chars.

Example — attach email from your checkout

curl -X POST https://api.tribridge.xyz/payments/checkout/<PAYMENT_ID>/customer \
  -H "Content-Type: application/json" \
  -d '{
    "email": "jane@example.com",
    "name": "Jane Doe"
  }'

You can also pass customer_email / customer_name directly when creating the session — use this endpoint when the email is collected later (e.g. on your own hosted form).

Authorizations

x-api-key

string

header

required

Path Parameters

string<uuid>

required

Body

application/json

string<email>

required

Valid payer email address.

Maximum string length: 254

Example:

"jane@example.com"

name

string

Payer name for the receipt.

Maximum string length: 120

Example:

"Jane Doe"

Response

Contact details stored

Checkout Sessions

Payment Links

Webhooks & Refunds

Status

Developers

Save customer details

Rules

Authorizations

Path Parameters

Body

Response

​Rules

Authorizations

Path Parameters

Body

Response

Rules