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

Environment	Method	URL	Version
Development	POST	https://snapstag.finnet.co.id/api/v1.0/upgrade-account-widget	V 1.0
Production	POST	https://snap.finnet.co.id/api/v1.0/upgrade-account-widget	V 1.0

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

{
  "partnerReferenceNo": "202411011441000012",
  "phoneNo": "6281295288912",
  "merchantId": "AGREE170724",
  "merchantPass": "Z0gKf5KKPvvrPpe2BjtBJw==",
  "images": {
    "ktp": {
      "base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ...",
      "isEditable": false
    },
    "selfie": {
      "base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ...",
      "isEditable": true
    }
  },
  "personalData": {
    "kkNumber": "1jdzWuniG6UMtoa3T6uNLA==",
    "biologicalMotherName": "1jdzWuniG6UMtoa3T6uNLA==",
    "nationality": "ID",
    "email": "[e-mail]"
  }
}

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

{
  "responseCode": "2000000",
  "responseMessage": "Request has been processed successfully",
  "widgetUrl": "https://demos.finnet.co.id/mob-dev/widget/prem?phone=6281295288912&uuid=04667364-ef55-46c6-9006-8c99388e4cdd",
  "expiryTime": "2024-11-01 14:01:10"
}

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