Create Invoice

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

POSThttps://tokoapisnap-stg.netzme.com/api/{version}/invoice/create

Request

Parameter	Data Type	Description
custIdMerchant	String	User ID
partnerReferenceNo	String	API request identifier from the user's system, unique for each request
amount	Object
value	String	Value of Amount
currency	String	Currency of Amount
amountDetail	Object
basicAmount	Object
value	String	Value of basicAmount
currency	String	Currency of basicAmount
shippingAmount	Object
value	String	Value of shippingAmount
currency	String	Currency of shippingAmount
commissionPercentage	Int	Percentage of commission
additionalInfo	Object
email	String	Customer email
notes	String	Invoice note
description	String	Order description
phoneNumber	String	Customer phone number
imageUrl	String	url image
fullname	String	Customer fullname

{
    "custIdMerchant": "M_TB1NMLig",
    "partnerReferenceNo": "testing20210409144959687",
    "amount": {
        "value": "50000.00",
        "currency": "IDR"
    },
    "amountDetail": {
        "basicAmount": {
            "value": "50000.00",
            "currency": "IDR"
        },
        "shippingAmount": {
            "value": "9000.00",
            "currency": "IDR"
        }
    },
    "commissionPercentage": 0,
    "additionalInfo": {
        "email": "[e-mail]",
        "notes": "desc",
        "description": "description",
        "phoneNumber": "[phone]",
        "imageUrl": "",
        "fullname": "Tester 2"
    }
}

Response

Parameter	Data Type	Description
responseCode	String	(HTTP status code + service code + case code)
responseMessage	String	Description of responseCode
partnerReferenceNo	String	API request identifier from the user's system
paymentUrl	String	payment url
additionalInfo	Object
invoiceId	String	ID invoice
status	Boolean	Status

Response Body

{
    "responseCode": "2000000",
    "responseMessage": "Successful",
    "partnerReferenceNo": "testing20210409144959687",
    "additionalInfo": {
        "invoiceId": "NETZ-INV-M_TB1NMLig36136158886034181yS5",
        "status": true
    }
}

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 'http://localhost:9007/api/v1.0/invoice/create' \
--header 'X-TIMESTAMP: 2022-08-10T00:00:00+07:00' \
--header 'X-SIGNATURE: 2100e98c9b222c6ed5a90d0f61946360a1586f81732056c828c22188dbe687a59e02e692038a8355b00cb22c5ce3b469cd2f8d83a7013175e50b8e4a480a5c2f' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2Njk0OTE5OTcsImlhdCI6MTY2OTQzNzk5NywiaXNzIjoiYnNuYXAifQ.W22-JQ483h5iZ_wzUT-NlnwxXgrPX_58ftxrnXZe0gfHh3NViNawDyLtTmRh8e8ODUbznolc0iWUsdokfHXalw' \
--header 'X-PARTNER-ID: TokoNetmeClientId' \
--header 'X-EXTERNAL-ID: 41807553358950093184162180797837' \
--header 'CHANNEL-ID: 95221' \
--data-raw '{
    "custIdMerchant": "M_uUByxy5E",
    "partnerReferenceNo": "testing1234",
    "payMethods": [
        "BANK_TRANSFER"
    ],
    "amount": {
        "value": "100.00",
        "currency": "IDR"
    },
    "additionalInfo": {
        "email": "[e-mail]",
        "notes": "desc",
        "description": "description",
        "phoneNumber": "[phone]",
        "imageUrl": "",
        "fullname": "Tester 2"
    },
    "amountDetail": {
        "basicAmount": {
            "value": "100.00",
            "currency": "IDR"
        },
        "shippingAmount": {
            "value": "50.00",
            "currency": "IDR"
        }
    },
    "commissionPercentage": 0
}'