Customer Top Up

This API will be used to cash-in the amount value into customer e-money account balance, crediting the account balance.

Technical Specification

Service Code: 38

Environment	Method	URL
Development	POST	https://snapstag.finnet.co.id/v1.0/emoney/topup
Production	POST	https://snap.finnet.co.id/v1.0/emoney/topup

Body Request

No	Name	Type	Mandatory	Min Length	Max Length	Description
1	partnerReferenceNo	String	M	1	64	Transaction identifier on service consumer system
2	customerNumber	String	M	1	16	Customer phone number with 08xx format
3	customerName	String	M	1	255	Customer name from inquiry response
4	amount	Object	M	1	2	Transaction Amount
5	feeAmount	Object	M	1	2	Fee amount object from inquiry response
6	transactionDate	String	M	1	25	YYYY-MM-DDThh:mm:ssZ format

Sample Request

{
  "partnerReferenceNo": "78912343452347893",
  "customerNumber": "081977817902",
  "customerName": "sa**",
  "amount": {
    "value": "10000.00",
    "currency": "IDR"
  },
  "feeAmount": {
    "value": "0.00",
    "currency": "IDR"
  },
  "transactionDate": "2022-09-23T14:56:11+07:00"
}

Body Response

No	Name	Type	Mandatory	Min Length	Max Length	Description
1	responseCode	Enum	M	1	7	BI SNAP Response Code.
2	responseMessage	String	M	1	150	BI SNAP Response Message.
3	referenceNo	String	O	1	64	Transaction identifier on service provider system
4	partnerReferenceNo	String	O	1	64	Transaction identifier on service consumer system
5	customerNumber	String	O	1	64	Masked customer phone number with 08xx format
6	customerName	String	M	1	255	Masked customer account name
7	amount	Object	O	1	2	Detail of amount transaction

Sample Response

{
  "responseCode": "2003800",
  "responseMessage": "Request has been processed successfully",
  "referenceNo": "2211150005490937",
  "partnerReferenceNo": "78912343452347893",
  "customerNumber": "081977817902",
  "amount": {
    "value": "10000.00",
    "currency": "IDR"
  }
}

Response Code & Message

The table below lists response codes and messages for the Customer Top Up API.

No	HTTP Code	Code	Message (Indonesian)
1	200	2003800	Successful
2	200	2003900	Request has been processed succesfully
3	400	4003800	Bad request
4	400	4003801	Invalid field format {field}
5	400	4003802	Invalid mandatory field {field}
6	401	4013801	Invalid token (B2B)
7	401	4013800	Unauthorised. [Reason]
8	403	4033801	Feature not allowed
9	403	4033804	Activity count limit exceeded
10	404	4043808	Invalid merchant
11	500	5003800	General error
12	504	5043800	Timeout