Create a customer

Creates a new customer; if the reference_number already exists, it updates that customer instead (idempotent).

Header parameters

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

Your side customer unique id

namerequired

string

The customer's name

Example: <Your Customer's name>

string

The customer's email

Example: abc@def.com

phonerequired

string

The customer's mobile phone

Example: 12345678

dial_code

string

The customer's mobile phone country code

Example: +852

company_name

string

The customer's company name

Example: Universal Group Limited

reference_numberrequired

string

Your side unique number

Example: <Your side the customer unique id>

default_payment_token

string<uuid>

Set a default payment token of this customer

Example: 1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed

default_payment_method

enum<string>

Default payment method: Credit Card, Alipay or Wechat Pay

Credit CardAlipayWechat Pay

Example: Credit Card

Responses

code

number

Response code

required

object

Response data

required

object

message

string

Response message

curl -X POST "https://api.wonder.app/svc/payment/api/v1/openapi/customers" \ -H "Content-Type: application/json" \ -H "Signature: <Signature>" \ -H "Credential: <Credential>" \ -H "x-request-id: <x-request-id>" \ -H "x-i18n-lang: <x-i18n-lang>" \ -d '{"customer":{"name":"<Your Customer's name>","email":"abc@def.com","phone":"12345678","dial_code":"+852","company_name":"Universal Group Limited","reference_number":"<Your side the customer unique id>","default_payment_token":"1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed","default_payment_method":"Credit Card"}}'

{ "customer": { "name": "<Your Customer's name>", "email": "abc@def.com", "phone": "12345678", "dial_code": "+852", "company_name": "Universal Group Limited", "reference_number": "<Your side the customer unique id>", "default_payment_token": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed", "default_payment_method": "Credit Card" } }

{ "code": 200, "data": { "customer": { "name": "禚雨欣", "uuid": "feac5c50-010a-4582-a84a-673357245ffb", "email": "i8lv9r_gxn26@gmail.com", "phone": "013 9957 0539", "dial_code": "+852", "reference_number": "35", "default_payment_token": { "state": "success", "token": "culpa magna", "default": false, "token_type": "CreditCard", "credit_card": { "brand": "Visa", "number": "39", "exp_year": "2026", "exp_month": "十月", "holder_name": "有超栋", "billing_currency": "HKD" } }, "default_payment_method": "Credit Card" } }, "message": "success" }