Create a customer

POST

/api/v1/customers/create

Request

Header Params

Body Params application/json

Example

{
    "name":"eric wang"
    ,"email":"eric.wang@useepay.com"
    ,"merchant_customer_id":"1000000021137"
    ,"phone":"13527156763"
    ,"address":{
        "country":"CN"
        ,"city":"shanghai"
        ,"postcode":"200100"
        ,"state":"shanghai"
        ,"line1":"pudong zhangjiang"
        ,"line2":"room 1002"
    }
    ,"description":"test customer"
    ,"metadata":{
        "testkey":"12233"
    }
    ,"shipping":{
        "name":"zhangsan"
        ,"phone":"13527189021"
        ,"address":{
            "country":"CN"
            ,"city":"shanghai"
            ,"postcode":"200100"
            ,"state":"shanghai"
            ,"line1":"minghang pushenglu"
            ,"line2":"room 2002"
        }
    }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi1.uat.useepay.com/api/v1/customers/create' \
--header 'x-merchant-no: 500000000007245' \
--header 'x-api-key: FUYTIUvjhgfytfuytwiue' \
--header 'x-app-id: www.pay.com' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name":"eric wang"
    ,"email":"eric.wang@useepay.com"
    ,"merchant_customer_id":"1000000021137"
    ,"phone":"13527156763"
    ,"address":{
        "country":"CN"
        ,"city":"shanghai"
        ,"postcode":"200100"
        ,"state":"shanghai"
        ,"line1":"pudong zhangjiang"
        ,"line2":"room 1002"
    }
    ,"description":"test customer"
    ,"metadata":{
        "testkey":"12233"
    }
    ,"shipping":{
        "name":"zhangsan"
        ,"phone":"13527189021"
        ,"address":{
            "country":"CN"
            ,"city":"shanghai"
            ,"postcode":"200100"
            ,"state":"shanghai"
            ,"line1":"minghang pushenglu"
            ,"line2":"room 2002"
        }
    }
}'

Responses

🟢200Success

application/json

Body

Example

{
    "id": "cus_1J6N9TPUSIG00",
    "address": {
        "country": "CN",
        "city": "shanghai",
        "postcode": "200100",
        "state": "shanghai",
        "line1": "pudong zhangjiang",
        "line2": "room 1002"
    },
    "description": "test customer",
    "name": "eric.wang",
    "email": "eric.wang@useepay.com",
    "phone": "13527156763",
    "metadata": {
        "testkey": "12233"
    },
    "shipping": {
        "address": {
            "country": "CN",
            "city": "shanghai",
            "postcode": "200100",
            "state": "shanghai",
            "line1": "minghang pushenglu",
            "line2": "room 2002"
        },
        "name": "zhangsan",
        "phone": "13527189021",
        "first_name": null,
        "last_name": null,
        "shipping_method": null
    },
    "merchant_no": "500000000007264",
    "app_id": "www.pay.com",
    "create_at": "2024-10-12T10:09:53Z",
    "modify_at": "2024-10-12T10:09:53Z",
    "first_name": null,
    "last_name": null,
    "merchant_customer_id": "1000000021134"
}

🟠400Bad Request

🟠401Unauthorized

🔴500Internal Server Error

Modified at 2025-03-10 07:58:49

Customers

Retrieves a customer