Update Account API

put

https://sandbox.api.of.ayoconnect.id/em/api/v1.0/update-account

This API partially updates an existing E-Wallet account. Omitted fields remain unchanged. email, name, and phoneNo are optional profile fields and are updated when provided without KYC validation dependency. The merchant may update KYC document references, set the account to INACTIVE the account, update wallet balance, or combine supported changes in one request. ADDITION adds the submitted balance value to the current balance, SUBTRACTION subtracts the submitted balance value from the current balance, and PATCH replaces the current balance with the submitted value.

Ayoconnect E-Wallet Management extension. Service Code: 80

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

partnerReferenceNo, customerId, and merchantId are mandatory. All other fields are conditional update fields. At least one conditional update field must be provided. Omitted fields remain unchanged.

partnerReferenceNo

string

required

length between 32 and 32

^[A-Za-z0-9]{32}$

Unique 32-character transaction identifier generated by the partner.

customerId

string

required

length between 1 and 45

^[A-Za-z0-9_-]+$

Customer account identifier defined by the merchant. Must be unique within the merchant and is used as the E-Wallet account identifier.

string

length ≤ 254

Conditional. Provide only when the customer email needs to be updated. No KYC validation dependency is applied.

name

string

length between 1 and 128

Conditional. Provide only when the customer name needs to be updated. No KYC validation dependency is applied.

phoneNo

string

length between 1 and 32

Conditional. Provide only when the customer phone number needs to be updated. No KYC validation dependency or duplicate-phone validation is applied.

merchantId

string

required

length between 6 and 6

6-character merchant identifier unique to each merchant.

additionalInfo

object

Conditional. Provide only when one or more additional account fields need to be updated.

Headers

X-TIMESTAMP

string

required

length between 24 and 27

Client's current local time in yyyy-MM-ddTHH:mm:ssTZD ISO-8601 format.

X-SIGNATURE

string

required

Represents the signature of a request. Symmetric signature: HMAC_SHA512(clientSecret, stringToSign). stringToSign = HTTPMethod + ":" + URLPath + ":" + AccessToken + ":" + Lowercase(HexEncode(SHA-256(minify(RequestBody)))) + ":" + X-TIMESTAMP

X-PARTNER-ID

string

required

length between 6 and 6

6-character merchant identifier unique to each merchant.

X-EXTERNAL-ID

string

required

length between 32 and 32

^[A-Za-z0-9]{32}$

Alphanumeric unique identifier generated by the merchant for each API request attempt.

CHANNEL-ID

string

required

length between 5 and 5

^[0-9]{5}$

Numeric PJP channel identifier. Must remain consistent within the same flow.

Responses

200Account Updated Successfully

400Failed Operation

401Unauthorized

404Account Not Found

409Conflict

500Backend System Failure