Netzme vSNAP
  • Introducing
  • Getting Started
  • API Reference
    • Toko Netzme
      • Credentials & Signature
      • Authentication
      • Create pin
      • Forgot pin
      • Get Balance Detail
      • Get Transaction List
      • Get Merchant Detail
      • Withdraw Inquiry
      • Get Information Withdraw
      • Get QRIS Acquire Transaction
      • Create Invoice
      • Create Invoice Transaction
      • Create Invoice QR MPM
      • Get Invoice Transaction
      • Payment Success Callback (Invoice)
      • Payment Success Callback (QRIS Non Invoice )
      • Payment Success Callback V2
        • Payment Success Callback QRIS
        • SNAP Payment Success Callback QRIS
      • Withdraw Status Notification
      • Deduct Deposit and Split Fee
      • Deposit
        • Create Invoice Transaction Topup Deposit
        • Inquiry Withdraw Deposit
        • Withdraw Deposit
        • Get Information Withdraw Deposit
        • Get Deposit Transaction
        • Get Balance Deposit
      • Withdraw Process
      • SNAP Asymmetric Signature
    • Netzme
      • Connect to Netzme
      • Credentials & Signature
      • Authentication
      • Get Account Status
      • Get Balance
      • Get History
      • Get Fixed Topup VA
      • Get Detail Qris
        • QRIS Static
        • QRIS Static With Amount & Percentage Fee
        • QRIS Dynamic
        • QRIS Dynamic with Fee
      • QRIS Payment
      • QRIS Payment Notification
      • Payment Bill
      • Payment Bill Notification
      • Payment Netzme Seamless
      • Upgrade Account Notification
      • Upgrade Account
Powered by GitBook
On this page
  1. API Reference
  2. Toko Netzme

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

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": "testabc@gmail.com",
        "notes": "desc",
        "description": "description",
        "phoneNumber": "+62813293333333",
        "imageUrl": "a",
        "fullname": "Tester"
    }
}
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=+6285270427851&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"
    }
}
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

X-TIMESTAMP

Client's current local time in yyyy-MM-ddTHH:mm:ssTZD

Authorization

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": "testabc@gmail.com",
        "notes": "desc",
        "description": "description",
        "phoneNumber": "+6285270427851",
        "imageUrl": "a",
        "fullname": "Tester"
    }
}'

PreviousCreate InvoiceNextCreate Invoice QR MPM

Last updated 10 months ago

Service’s signature (given at )

Client`s access for protected resources (given at )

Authentication
transactional signature