Start saving PayPal

POST/v1/paypal/wallet/setup-token

Creates the PayPal Vault setup token the user approves in PayPal, for one merchant-initiated token billed on the terms of the mandates they sign.

Headers

idempotency-keystringRequired
Idempotency-KeystringRequired: 1 to 255 characters. A retry with the same key returns the first answer.

Responses

201The setup token
401Not signed in
422PayPal refused
503PayPal is unavailable

201 response

setupTokenstringRequired

curl -X POST https://api.keelson.finance/v1/paypal/wallet/setup-token \
  -H 'idempotency-key: <idempotency-key>' \
  -H "idempotency-key: $(uuidgen)"

const res = await fetch("https://api.keelson.finance/v1/paypal/wallet/setup-token", {
  method: "POST",
  headers: {
    "idempotency-key": "<idempotency-key>",
    "idempotency-key": crypto.randomUUID(),
  },
});
const data = await res.json();

Response · shape from the schema

{
  "setupToken": "string"
}