Create an invoice

In order to call up the page for filling Golomt bank’s card information, an invoice number which contains such data as the merchant’s number, transaction number and amount must be created in advance. This invoice number is called as a parameter on the customer’s browser, so the card filling page is displayed

Service workflow

When customer requests for payment, the merchant sends an invoice request with the parameters required for the bank to our../api/merchant/invoice link by using the httpRequest POST method, so the bank system sends response containing the invoice number.
The invoice number is used to call up the bank page on the customer’s browser. The customer’s card information is received and the transaction is made on the bank system.

Function calling path

https://ecommerce.golomtbank.com/api/invoice

Parameters required for merchant request

Json format:

{
  "amount": "string",
  "callback": "string",
  "checksum": "string",
  "genToken": "string",
  "returnType": "string",
  "transactionId": "string",
  "socialDeeplink": "string"
}

Parameters	Type	Definition
amount	String	Amount to withdraw from card
callback	String	Callback from customer browser or merchant’s url for redirect
checksum	String	`checksum` = `transactionId` +`amount` + `returnType` + `callback`
genToken	String	at `Y` after the transaction is made get a token representing the card. At `N`, no token is received.
returnType	String	`POST` `GET` value of redirecting to merchant’s url. Call app deeplink at `MOBILE`.
transactionId	String	Merchant's transaction number.
socialDeeplink	String	At `Y`, get socialpay deeplink, at `N`, no

checksum Read the link for details.

genToken: setup to get the token to use for pay or token transaction. Read this link for details.

transactionId: less than 16 digits, containing both digits and letters or just digits.

Response for successful transaction

Json:

{
  "checksum": "9ac76e1ecd0cb23b25cf2dbf976de7bc4d6ff11aebfbd83216aae29be16534b8",
  "transactionId": "P544F455K809",
  "invoice": "d7fb2858-df36-469e-b40d-2815fe9215cf",
  "socialDeeplink": "socialpay-payment://key=VnEWLv/nmtt2LbKjvujI8toXiR1RFt6d7zmGxNvFiHnR5YfNLDu/bx1gHRsK8PjwQbEwxcU1q4fsAPHqHRtrDPdsFQiug/vCFNNux9YbTEg="
}

Parameter	Type	Definition
checksum	String	Checksum created by the Bank `checksum` = `invoice` + `transactionId`
transactionId	String	Merchant's transaction number
invoice	String	Invoice number created on the transaction number
socialDeeplink	String	Socialpay deeplink

API

Checksum

API