Query Customer Detail

Function Description

• Query customer detail

Query Customer Detail API

Request URL

• /payee/custom/detail

Request Method

• GET

Request Parameters

The request parameters are as follows：

• Header

  • View request/response headers

• Request Body

TIP

If one of the merchant customer ID and system customer ID is not transmitted, the interface will respond to parameter missing errors.

parameter	Required	Type	Default Value	Description
mercustomid	N	string	-	Merchant customer ID, length limit 128 characters
customid	N	string	-	System customer ID, length limit 64 characters

Response Parameters

The response parameters are as follows：

• Response Body

Parameter	Type	Description
customid	string	System customer ID
mercustomid	string	Merchant customer ID
name_e	string	Customer english name
name_a	string	Customer arabic name
address	string	Address information bound to the customer bank card
identity	string	ID number (sensitive information, encrypted with merchant public key)
identitypic	string	ID card photo URL (sensitive information, encrypted using merchant public key)
signpic	string	Signature photo URL (sensitive information, encrypted using merchant public key)
bankname	string	Bank name
bankcode	string	Bank code
cardno	string	Bank account (sensitive information, encrypted using merchant public key)
ibanaccount	string	IBAN
swiftcode	string	Swift code corresponding to the customer bank account
stcaccount	string	STCPay account (sensitive information, encrypted using merchant public key)
status	number	Customer status
statusdesc	string	Customer status description
autoapproval	number	Whether to enable automatic approval: 0: Disable 1: Enable
otpappname	string	Product name for sending OTP verification
demand_perfection	array	What information does the user currently need to improve
created_at	number	Creation time
updated_at	number	Update time

Response Parameter Example

{
    "code": 200,
    "message": "Request succeeded.",
    "data": {
        "customid": "12ad4",
        "mercustomid": "u004",
        "name_e": "usera",
        "name_a": "usera",
        "address": "Saudi Arabia",
        "identity": "noGsqF+6wpnfchtRtiIjkuzL3t6YPFv3rqK1KobZf5cVnLRCZ7HjxoqMHoD9b+YHasd1izzd58GPJAl5DswpI8f4PxauKBv9ba45us0PlUZAUurpc0/8FmZrx/xuDTz+rtfGBUckUBiwz0iZXdbJ46PYAPdB9Hlz27Nn7eYU9UXBiluuISBKt/1Q1aJ4nKfhjvONntmDXOUyP719hD8BIyjD3aYYK96OxwIrPCbT4nDMbA/qQdhboOVPQTdom774OWUjlVv32bU7Ck1jzmERvsMptCkveb/Qjr4b/9Z6ZKDIx0VtPPzHDtffNwRohfpEv9RiKzG4RM52Mfr3jV78Eg==",
        "identitypic": "",
        "signpic": "",
        "bankname": "Riyad Bank",
        "bankcode": "1174c",
        "cardno": "jH8+rl4v3EqKOZWgyacTtNhGGdP+DvyRpeVhDuXhvEam4pcI2vuPEUMtAaYD6LOpZ85z8sHZd344dDzTLmNuIOMs9GnvdrV0RA2kCqwHHIkgRshci1CHE/S4Ds+MBNdCcs+eeVYGHMa/PH2dZRIsYpdkGw17ldUxF8TL2gcRyNZvF/VWz3ZduuKUwFZ3eYeqLmMoAwQcslPZNcAPW28vXhiPw4DSyPc9jp1wRJWVLLVaTXYrSnx5847I0WscR++O052XSuSUPLlKsjhNVXKPW/3QPkAHifvIRxwgEb2tv9y7Clxp8GrD1K+vpojs3yhSpaUiPiVb6MEgXZq2In0rBA==",
        "ibanaccount": "1234567892",
        "swiftcode": "ABNACNSHXXX",
        "stcaccount": "",
        "status": 4,
        "statusdesc": "2023-06-15 06:12:54",
        "autoapproval": 1,
        "otpappname": "test",
        "demand_perfection": [
            "identitypic"
        ],
        "created_at": 1686809574,
        "updated_at": 1686809574
    },
    "sensitiveFields": [
        "identity",
        "identitypic",
        "signpic",
        "stcaccount",
        "cardno"
    ],
    "requestId": "13AB5E3E15526172EF73CB2939D08535"
}