Create Invoice Transaction Splitfee Invoice

Endpoint for a merchant to create Invoice transaction (Payment Link) via API. This API can also generate the Virtual Account Number and Payment Url for paying the transaction.

Create Invoice Transaction

POST https://pay-stg.netzme.com/api/v1/invoice/createTransaction

Headers

Name	Type	Description
User-Agent*	string	<client name;merchant_id>
Authorization*	string	custom <access token>
Content-Type*	string	application/json

Request Body

Name	Type	Description
merchant*	string	merchant ID
amount*	number	Amount that need to be paid
email*	string	Buyer's email
notes*	string	notes
phone_number*	string	Buyer's phone number
description*	string	Product description/Invoice description
image_url*	string	URL your company logo to put on the invoice
fullname*	string	Buyer's name. Must be alphabetic
amount_detail*	object	(Optional) If there is additional amount (i.e shippingAmount)
commission_percentage*	number	(Optional) Percentage commission value (0-100)
type*	string	Fill with "single" or "multiple". Default is "single"
payment_method*	string	Fill with "BANK_TRANSFER", "NETZME", "BCA" , "QRIS" , "RETAIL_OUTLET", "OVO" , "NETZME_SEAMLESS", "DANA" or "CREDIT_CARD"
fee_type*	String	Charge service fee type. Fill with "on_buyer" or "on_seller". Default is "on_seller"
partner_transaction_id	String	Partner transaction id register on partner netzme
apiSource	String	Filled topup_deposit for create invoice topup deposit on netzme. Don't provide this parameter if transaction invoice non topup deposit. For sample json request click here
terminal_id	String	(Optional) Qris terminal id A01-Z99 only used payment method QRIS. Default A01
isSplitFee*	boolean	Set this field to true to indicate that the invoice is a split fee transaction.
splitFees*	List<Object>	A list containing the split fees details for each merchant

200: OK Success

{
    "result": {
        "id": "NETZ-INV-M_QLjyEqWF-20220111-032",
        "trxId": "fc841c08dcf04bfd914f68e1c57dd1dd",
        "paymentMethod": "BCA",
        "expiredTs": "2022-01-11T16:45:02.966+07:00",
        "paymentUrl": "https://dev.faspay.co.id/pws/100003/0830000010100000/1c9a6aed4c14c70908c3c082138d2f8c97908ebe?trx_id=3262670200007351&merchant_id=32626&bill_no=fc841c08dcf04bfd914f68e1c57dd1dd",
        "virtualAccountData": [
            {
                "bankCode": "BCA",
                "virtualAccountNo": "3262670200007351"
            }
        ],
        "qrImage": "data:image/png;base64," 
    },
    "status": true,
    "message": null,
    "statistic": [],
    "code": 200
}

200: OK Netzme Seamless success response

{
    "result": {
        "id": "NETZ-INV-M_DAzd2l5k1697444991344H7P",
        "trxId": "05dab165-8e61-4fb4-b9ff-d94c937dcfeb",
        "paymentMethod": "NETZME_SEAMLESS",
        "expiredTs": "2023-10-16T15:30:01.356+07:00",
        "paymentUrl": "https://xplorin-stg.netzme.id/pin-transaction?type=aggregator_payment_netzme_seamless&aggregatorId=ITCPaySeamless&billId=05dab165-8e61-4fb4-b9ff-d94c937dcfeb&paymentMethod=NETZME_SEAMLESS&phoneNo=[phone]&userId=i8lGbAgE&amount=15000&description=donaTest+invoice+transaction&expired=2023-10-16T15:30:01.356+07:00&token=D87BAB894022D7F9E7D11672F9098510981F567EF0A8462D52DE65CE3244C7E6",
        "virtualAccountData": [],
        "netzmeSeamlessToken": "D87BAB894022D7F9E7D11672F9098510981F567EF0A8462D52DE65CE3244C7E6"
    },
    "status": true,
    "message": null,
    "statistic": [],
    "code": 200
}

200: OK Splitfee invoice success

{
    "result": {
        "id": "NETZ-INV-M_BIZyTkIX1705027776983Pvd",
        "trxId": "963bbb51f619485c8e89975c0bc5cd64",
        "paymentMethod": "QRIS",
        "expiredTs": "2024-01-12T11:49:36.983+07:00",
        "paymentUrl": "https://pay-stg.netzme.id/warungbadran/NETZ-INV-M_BIZyTkIX1705027776983Pvd/qris/963bbb51f619485c8e89975c0bc5cd64",
        "virtualAccountData": [],
        "qrImage": "data:image/png;base64,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",
        "terminalId": "A01",
        "nmid": "ID2021000001732",
        "createdTs": "2024-01-12 09:49:37.063+07",
        "feeAmount": 51,
        "totalAmount": 10000,
        "merchantLocation": "Kota Yogyakarta",
        "isSplitFee": true,
        "splitFees": [
            {
                "merchantId": "M_Gq2HXf4z",
                "merchantType": "main",
                "originalAmount": 10000.0,
                "feeAmount": 61.0,
                "amount": 9939.0
            },
            {
                "merchantId": "M_yEPSxTSq",
                "merchantType": "splitFee",
                "originalAmount": 10000.0,
                "feeAmount": 0.0,
                "amount": 10000.0
            }
        ]
    },
    "status": true,
    "message": null,
    "statistic": [],
    "code": 200
}

Sample JSON Request

{
    "request": {
        "merchant": "M_Gq2HXf4z",
        "amount": 50000,
        "email": "[e-mail]",
        "notes": "desc",
        "description": "description",
        "phone_number": "[phone]",
        "image_url": "",
        "fullname": "Tester",
        "amount_detail" : {
            "basicAmount" : 50000,
            "shippingAmount" : 0
        },
        "payment_method": "QRIS",
        "commission_percentage" : 0,
        "expire_in_second": 600,
        "fee_type" : "on_seller",
        "partner_transaction_id" : "aggregator202103031542100001",
        "isSplitFee": true,
        "splitFees": [
            {
                "merchantId": "M_Gq2HXf4z",
                "merchantType": "main",
                "amount": 25000
            },
            {
                "merchantId": "M_yEPSxTSq",
                "merchantType": "splitFee",
                "amount": 25000
            }
        ]
    }
}