curl --request POST \
  --url https://sandbox-apigw.singapay.id/api/v1/kyc/ewallet/verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "request_id": "8b1d6f3e-9a02-4c5d-9f7a-2c8e1b3d4f5a",
  "phone_number": "081234567890",
  "name": "Budi Santoso",
  "ewallet_code": "DANA"
}
'

{
  "code": "SUCCESS",
  "message": "OK",
  "data": {
    "status": "found with kyc",
    "similarity": 96.5,
    "suggestion": "pass"
  },
  "request_id": "8b1d6f3e-9a02-4c5d-9f7a-2c8e1b3d4f5a",
  "pricing": "PAID"
}

E-Wallet

Verify a name against an e-wallet account

Looks up the registered holder name on the e-wallet for the given phone number and compares it with the name you send.

A completed check is billed (pricing=PAID), including when the account is not found. Validation errors and service failures are not billed (pricing=FREE).

Outcomes

Result	Response
Account found with a registered name	`code=SUCCESS`, `data.status="found with kyc"`, `pricing=PAID`
Account found, holder has not completed KYC	`code=SUCCESS`, `data.status="found without kyc"`, `similarity=0`, `suggestion=review`, `pricing=PAID`
No account for this phone	`code=SUCCESS`, `data.status="not found"`, `suggestion=reject`, `pricing=PAID`
Temporary service issue	`code=SERVER_ERROR`, `pricing=FREE`
Invalid request (phone, name, wallet, or `request_id`)	`code=CLIENT_ERROR`, `pricing=FREE`
Same `request_id` with a different body	`code=DUPLICATE_REFERENCE`, `pricing=FREE`
Missing token, or IP not allowlisted	`code=UNAUTHORIZED`, `pricing=FREE`
Prepaid balance too low	`code=INSUFFICIENT_BALANCE`, `pricing=FREE`

Phone numbers

Send Indonesian numbers as 08… or 62… (9–13 digits). Do not include spaces or a + prefix.

Idempotency

Use a unique request_id for each new check (UUID v4 is recommended). Repeating the same request_id with the same body returns the original result and is billed once. A different body with the same request_id returns DUPLICATE_REFERENCE.

POST

api

kyc

ewallet

verify

curl --request POST \
  --url https://sandbox-apigw.singapay.id/api/v1/kyc/ewallet/verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "request_id": "8b1d6f3e-9a02-4c5d-9f7a-2c8e1b3d4f5a",
  "phone_number": "081234567890",
  "name": "Budi Santoso",
  "ewallet_code": "DANA"
}
'

{
  "code": "SUCCESS",
  "message": "OK",
  "data": {
    "status": "found with kyc",
    "similarity": 96.5,
    "suggestion": "pass"
  },
  "request_id": "8b1d6f3e-9a02-4c5d-9f7a-2c8e1b3d4f5a",
  "pricing": "PAID"
}

Authorizations

Authorization

string

header

required

Access token from POST /api/v1/kyc/auth/get-auth-token. Valid for one hour.

Body

application/json

request_id

string

required

Your unique reference for this check. Use a new UUID for each new verification. Sending the same key with the same body returns the original result and is billed once.

Example:

"8b1d6f3e-9a02-4c5d-9f7a-2c8e1b3d4f5a"

phone_number

string

required

E-wallet phone number. Use 08… or 62… (9–13 digits). No spaces or +.

Pattern: ^(0|62)[1-9][0-9]{7,11}$

Example:

"081234567890"

name

string

required

Name to compare with the registered wallet holder. Extra spaces and common honorifics are ignored when scoring.

Required string length: 1 - 200

Example:

"Budi Santoso"

ewallet_code

enum<string>

required

Wallet to check. Only this wallet is queried.

Available options:

DANA,

SHOPEEPAY,

GOPAY,

OVO

Response

Check complete (whether the account exists or not). code is SUCCESS. Read data.status and data.suggestion for the outcome. pricing is PAID.

code

enum<string>

required

Always SUCCESS on this response. Read data for the outcome.

Available options:

SUCCESS

Example:

"SUCCESS"

message

enum<string>

required

Always OK. Use code and data, not this field, to branch.

Available options:

OK

Example:

"OK"

data

object

required

Show child attributes

request_id

string

required

The request_id you sent.

Example:

"8b1d6f3e-9a02-4c5d-9f7a-2c8e1b3d4f5a"

pricing

enum<string>

required

Always PAID on this response — including when data.status is not found.

Available options:

PAID

Example:

"PAID"