For the complete documentation index, see llms.txt. This page is also available as Markdown.

Upgrade Account Widget

This service will redirect customer to a widget to make an upgrade from Basic account to Premium account, enabling access to all Linkage features.

Technical Specification

Body Request

No
Name
Type
Mandatory
Min Length
Min Length
Description
1

partnerReferenceNo

String

M

10

64

Partner-side unique transaction reference number.

2

phoneNo

String

M

10

15

Valid phone format 62xx, 08xx

3

merchantId

String

M

128

Partner merchant ID (provided by Finnet).

4

merchantPass

String

M

-

Merchant password (provided by Finnet).

The data must be AES-128 encrypted.

  • Sample: 123456

  • Secret key: 1234567890123456

  • IV value: 1234567890123456

  • Encrypt result: 1jdzWuniG6UMtoa3T6uNLA==

5

redirectFinalUrl

String

O

-

URL to redirect the Back button to the merchant page.

6

images

Object

O

-

Container object for placeholder images.

7

images.ktp

Object

C

-

Container object for the KTP placeholder image.

8

images.ktp.base64

String

C

Base64 string of the user's e-KTP photo. Used as a prefilled image in the widget. Prefix data:image/...

9

images.ktp.isEditable

Boolean

C

Valid values: [true , false] Widget config:

• true: user can change/re-take the KTP photo.

• false: user must use the provided photo (read-only).

10

images.selfie

Object

C

-

Container object for the selfie placeholder image.

11

images.selfie.base64

String

C

Base64 string of the selfie photo with KTP.

12

images.selfie.isEditable

Boolean

C

Valid values: [true , false]

Widget config:

• true: user can change/re-take the selfie photo.

• false: user must use the provided selfie photo.

13

personalData

Object

O

-

Container object for additional identity data (Dukcapil).

14

personalData.kkNumber

String

C

16

User's Family Card (KK) number as per Dukcapil data.

The data must be AES-128 encrypted.

  • Sample: 123456

  • Secret key: 1234567890123456

  • IV value: 1234567890123456

  • Encrypt result: 1jdzWuniG6UMtoa3T6uNLA==

15

personalData.biologicalMotherName

String

C

Mother's maiden name for population data verification.

The data must be AES-128 encrypted.

  • Sample: 123456

  • Secret key: 1234567890123456

  • IV value: 1234567890123456

  • Encrypt result: 1jdzWuniG6UMtoa3T6uNLA==

16

personalData.nationality

String

C

Valid values: [WNI, WNA]

Nationality country code.

17

personalData.email

String

C

User's active email address for account notifications.

Sample Request

Body Response

No
Name
Type
Mandatory
Min Length
Max Length
Description

1

responseCode

Enum

M

Response Code

2

responseMessage

String

M

Response Message.

3

widgetUrl

String

M

URL Widget for Upgrade Account

4

expiryTime

String

M

Expiry time for the widget

Sample Response

Response Code List

No
HTTP Code
SVC Code
RC Code
RC Desc

1

202

00

00

KYC Still on process

2

200

00

01

KYC Rejected

3

200

00

02

KYC Approved

Last updated