Skip to content

Securities

Newest version of API implements :

  • Authorization Basic Header
  • Usage of secure data signature. We will provide you Hash Key that only you know.
  • Unique external_id and it's all different to every merchant
  • Combination usage of hash key + external id + order_id to make sure all the data is send from merchant, and ultimately yours.
  • Every callback from MC Payment contain mcp-signature that merchant need to handle, to make sure that every signature from us is legit based on your create signature and requested data

Request Header

KeyValueRequirementDescription
Authorization"Basic "+ Base64(merchant_id+":"+secret_unbound_id)MPrevious version was using combination of api_key:secret_key, please adjust to the newest combination
Content-Typeapplication/jsonM
x-req-signaturesha256(hash_key+external_id+order_id)MUnique signature every request.
x-versionv3MInternal Merchant Information (not Payment gateway version)
sub-merchant-idmerchant_idCIt is mandatory if a merchant is a sub-merchant. When sending sub-merchant-id, use the hash_key of that submerchant. And the value of sub-merchant-id is submerchant_name.

iFortepay API Documentation