Create Invoice Transaction

The available versions for this api are v1.0 and v2.0.

POST https://tokoapisnap-stg.netzme.com/api/{version}/invoice/create-transaction

Request

Parameter	Data Type	Description
custIdMerchant	String	Merchant ID
partnerReferenceNo	String	GUID
amount	Object	Transaction Amount
value	String	Value amount
currency	String	Currency amount
amountDetail	Object	Detail of amount
basicAmount	Object
value	String	Value amount
currency	String	Currency amount
shippingAmount	Object	Shipping amount
value	String	Value amount
currency	String	Currency amount
PayMethod	String	Fill with "BANK_TRANSFER", "NETZME", "BCA" , "QRIS" , "RETAIL_OUTLET", "OVO" , "NETZME_SEAMLESS", "DANA" or "CREDIT_CARD"
commissionPercentage	Int	Percentage of commision
expireInSecond	String	Expire time
feeType	String	Charge service fee type. Fill with "on_buyer" or "on_seller". Default is "on_seller"
additionalInfo	Object
email	String	Buyer's email
notes	String	Notes
description	String	Description
phoneNumber	String	Buyer's phone number
imageUrl	String	URL your company logo to put on the invoice
fullname	String	Buyer's name. Must be alphabetic

{
    "custIdMerchant": "M_TB1NMLig",
    "partnerReferenceNo": "testing20210409144959687",
    "amount": {
        "value": "50000.00",
        "currency": "IDR"
    },
    "amountDetail": {
        "basicAmount": {
            "value": "50000.00",
            "currency": "IDR"
        },
        "shippingAmount": {
            "value": "0.00",
            "currency": "IDR"
        }
    },
    "payMethod": "BCA",
    "commissionPercentage": "0",
    "expireInSecond": "600",
    "feeType": "on_seller",
    "additionalInfo": {
        "email": "[e-mail]",
        "notes": "desc",
        "description": "description",
        "phoneNumber": "[phone]",
        "imageUrl": "a",
        "fullname": "Tester"
    }
}

Response

Parameter	Data Type	Description
responseCode	String	(HTTP status code + service code + case code)
responseMessage	String	Description of responseCode
partnerReferenceNo	Object	GUID
paymentMethod	String	Selected payment method
paymentUrl	String	Url for conduct payment
additionalInfo	Object
expiredTs	String	Timestamp the payment url will expire
id	String	Invoice ID
retailOutletData	Object	Retail outlet data (if any)
trxId	String	TransactionID
virtualAccountData	Object	Data virtual account
bankCode	String	Bank code
virtualAccountNo	String	Virtual account number
statistic	Array	statistik
status	Boolean	status
netzmeSeamlessToken	String	Payment token with the "Netzme Seamless" method

Response Body

{
    "responseCode": "2004700",
    "responseMessage": "Successful",
    "partnerReferenceNo": "testing20210409144959687",
    "payMethod": "BCA",
    "paymentUrl": "",
    "additionalInfo": {
        "expiredTs": "0001-01-01T00:00:00Z",
        "id": "",
        "retailOutletData": null,
        "trxId": "",
        "virtualAccountData": null,
        "statistic": [],
        "status": true
    }
}

Response Body Netzme Seamless

{
    "responseCode": "2004700",
    "responseMessage": "Successful",
    "partnerReferenceNo": "partnerReferenceNo",
    "payMethod": "NETZME_SEAMLESS",
    "paymentUrl": "https://xplorin-stg.netzme.id/pin-transaction?type=aggregator_payment_netzme_seamless&aggregatorId=xplorinsnap&billId=24ffbd87-6d03-4e7c-bf1e-740f966ddc4e&paymentMethod=NETZME_SEAMLESS&phoneNo=[phone]&userId=ImmxdBm3&amount=70001&description=desc&expired=2023-10-17T12:02:50.926+07:00&token=E145291A8A8AAFF85DF3641259D9D2F2A9BDF6E1741FD86376C5A5609B3B0DC0",
    "additionalInfo": {
        "qrImage": "",
        "terminalId": "",
        "nmid": "",
        "createdTs": "",
        "feeAmount": 0,
        "totalAmount": 0,
        "merchantLocation": "",
        "expiredTs": "2023-10-17T12:02:50.926+07:00",
        "invoiceId": "NETZ-INV-M_TB1NMLig1697518070913Wpf",
        "retailOutletData": null,
        "trxId": "24ffbd87-6d03-4e7c-bf1e-740f966ddc4e",
        "virtualAccountData": [],
        "statistic": [],
        "status": true,
        "netzmeSeamlessToken": "NETZME_SEAMLESS_TOKEN"
    }
}

Curl Example

Header	Value
Content-Type	application/json
CHANNEL-ID	e.g 95221
X-EXTERNAL-ID	e.g 41807553358950093184162180797837
X-PARTNER-ID	Client id e.g TokoNetmeClientId
X-SIGNATURE	Service’s signature (given at transactional signature)
X-TIMESTAMP	Client's current local time in yyyy-MM-ddTHH:mm:ssTZD
Authorization	Client`s access for protected resources (given at Authentication)

curl --location --request POST 'https://tokoapisnap-stg.netzme.com/api/v1.0/invoice/create-transaction' \
--header 'X-TIMESTAMP: 2022-08-10T00:00:00+07:00' \
--header 'X-SIGNATURE: 71338937c805237a54221c29cd6f79732919f8a95ee286f928af11652e3384e38f0233c03cf9ec95e37780eb4d4215ab144a9b75e2651b75ee7213046c0870c5' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2NjkzNDQ3NjMsImlhdCI6MTY2OTI5MDc2MywiaXNzIjoibG9rZXRkb3Rjb20ifQ.KdFbrQUDgRgZ5XKGAlxqlRCetEAYi1m73xlFYW2_VD8WJgfhx5__DahOPTkywsCU3NtwMqAxDCrfab74bNBCSg' \
--header 'X-PARTNER-ID: TokoNetmeClientId' \
--header 'X-EXTERNAL-ID: 41807553358950093184162180797837' \
--header 'CHANNEL-ID: 95221' \
--data-raw '{
    "custIdMerchant": "M_VWXPXk6t",
    "partnerReferenceNo": "testing2022112388888888012",
    "amount": {
        "value": "50000.00",
        "currency": "IDR"
    },
    "amountDetail": {
        "basicAmount": {
            "value": "50000.00",
            "currency": "IDR"
        },
        "shippingAmount": {
            "value": "0.00",
            "currency": "IDR"
        }
    },
    "PayMethod": "BANK TRANSFER",
    "commissionPercentage": "0",
    "expireInSecond": "3600",
    "feeType": "on_buyer",
    "additionalInfo": {
        "email": "[e-mail]",
        "notes": "desc",
        "description": "description",
        "phoneNumber": "[phone]",
        "imageUrl": "a",
        "fullname": "Tester"
    }
}'