post/svc/payment/api/v1/openapi/customers/wallet/link

Create Customer Wallet Link

Header parameters

X-Skip-Signature

string

Example: TRUE

Signature

string

Example: good

Credential

string

Example: {{credential}}

x-request-id

string

Example: {{$string.uuid}}

x-i18n-lang

string

Example: zh-CN

Content-typerequired

string

Example: application/json

Request body · application/json

required

object

mode

enum<string>

if mode = create_only, url is required

create_only

object

expires_at

string

Example: 2026-01-01T01:02:03Z

redirect_url

string

The target URL that redirect to when the user clicks the 'Back' button on the wallet link page

customer_uuidrequired

string

The customer's uuid

exp_redirect_url

string

Automatically redirect to this address when the link expires

Responses

coderequired

number

required

object

konnect_linkrequired

string

The customer's token manage website URL

Example: https://your.domain/foo/bar

messagerequired

string

Request · cURL

curl -X POST "https://api.wonder.app/svc/payment/api/v1/openapi/customers/wallet/link" \
  -H "Content-Type: application/json" \
  -H "X-Skip-Signature: <X-Skip-Signature>" \
  -H "Signature: <Signature>" \
  -H "Credential: <Credential>" \
  -H "x-request-id: <x-request-id>" \
  -d '{"customer":{"mode":"create_only","options":{"hide_default_card_element":true},"expires_at":"2026-01-01T01:02:03Z","redirect_url":"string","customer_uuid":"string","exp_redirect_url":"string"}}'

Request body example

{
  "customer": {
    "mode": "create_only",
    "options": {
      "hide_default_card_element": true
    },
    "expires_at": "2026-01-01T01:02:03Z",
    "redirect_url": "string",
    "customer_uuid": "string",
    "exp_redirect_url": "string"
  }
}

Response 200

{
  "code": 0,
  "data": {
    "konnect_link": "https://your.domain/foo/bar"
  },
  "message": "string"
}

PreviousCheck customer payment token state Next Get billing configs