Welcome to our IFP's Tech Documentations!
\n\n\nWe realized the last documentation is kinda hard to understand so we have done some arrangements and adjustment on it and here's the new one!
\n
IFP API is a RESTful Web Service served as a communication bridge between merchants and our payment channels. All our API request and response are using JSON. We do some basic but really the core services that you need to get your product and business go as easy as request, Integrate and let's go live!. No need to hustle on many third party payment vendors as we got your back on this one and it's all in one solutions~. IFP provides most of your payment needs from Bank Transfer, Electronic Money and YES! up until Credit Cards* transactions!.
\nWell if you need visualized solution, no worries! we IFP provides Payment Page that would be the fantastic solutions for your unique yet impressive products. We're not only providing a basic yet important services but also secured transactions. Not to mention IFP is growing company with amazing brilliant teams that would be happy to hear your opinions and problems because we're still improving!. So what holds you up to not try our service? Contact our Integrations teams (MRO) to get a taste of our services!
\n\n\n*Currently only available in Payment Page
\n
\n\n❗ All Services on PG 1 has been completely closed on 19 December 2022.
\n
❗Virtual Account on our Payment Gateway Version 2 is Available on Production! please let us know if you want to migrate/integrate with us. Card Payment on version 2 will be available soon! please contact our MRO for early access.
❗We're developing Merchant Dashboard which would make the integration process easier and also some new features will be available soon!. Improved Guarantee able credit card transactions which we're targeting to make it happen soon~.
Please contact our MRO / admin support to requesting the new integration credentials for our V2.
\nPlease refer to V2 section for latest integration update
\nPlease fill out the new SIT script and send back to our MRO.
\nSign the Minutes of Handover, send back to our MRO
\nMCP will prepare and update the production credentials to merchant PIC email.
\nMerchant will need to do the production transaction at least once and sign then return back the minutes of handover for production max in 5 working days to IFP MRO.
\nThe API must be requested through HTTPS Request to our Base URL endpoint. The HTTPS Header has to be used to allow proper authentication in our Production environment. All request in our staging environment will never hit the banking networks and you can always use our dummy payment API provided.
\n\n\nⓘ
\n
Note: pada tanggal 27 Okt 2025 free digit mandiri akan berubah menjadi 8
EndFragment
Refer to the Securities section
\n"},{"key":"x-version","value":"v3"}],"body":{"mode":"raw","raw":"{\n \"external_id\": \"{{extid}}\",\n \"order_id\": \"{{orderid}}\",\n \"currency\": \"IDR\",\n \"payment_method\": \"bank_transfer\",\n \"payment_channel\": \"{{channel}}\",\n \"payment_details\": {\n \"billing_name\": \"Nanas\",\n \"payment_system\": \"CLOSED\",\n \"va_number\": \"{{vanumber}}\",\n \"is_multi_use\" : false,\n \"amount\": 10000,\n \"is_customer_paying_fee\": false,\n \"expired_time\": \"{{expired_time}}\",\n \"transaction_description\": \"this is order description\"\n },\n \"customer_details\": {\n \"email\": \"customer@email.com\",\n \"full_name\" : \"My FullName\",\n \"phone\": \"0888888888\"\n },\n \"item_details\": [\n {\n \"item_id\": \"ID 12\",\n \"name\": \"item 1\",\n \"amount\": 10000,\n \"qty\": 1,\n \"description\": \"item description\"\n }\n ],\n\"shipping_address\": {\n \"full_name\":\"MC Payment\",\n \"phone\":\"123456\",\n \"address\":\"Warung jati 8a \",\n \"city\":\"Jakarta\",\n \"postal_code\":\"11111\",\n \"country\":\"Indonesia\"\n },\n\"billing_address\": {\n \"full_name\":\"MC Payment\",\n \"phone\":\"123456\",\n \"address\":\"Warung jati 8a \",\n \"city\":\"Jakarta\",\n \"postal_code\":\"11111\",\n \"country\":\"Indonesia\"\n },\n \"payment_options\": {\n \"referral_code\": \"agen 1\",\n \"promo_code\": \"\",\n \"source\": \"payment_page\"\n },\n \"additional_data\": \"remarks text or any json text\",\n \"callback_url\": \"https://testcallback.com\" \n}\n"},"url":"{{mcp_url_v2_staging}}/va","description":"Create VA with valid data
\nRefer to the Securities section
\n"},{"key":"x-version","type":"text","value":"v3"}],"body":{"mode":"raw","raw":"{\n \"external_id\":\"18457738645627\",\n \"order_id\":\"Test-01\",\n \"transaction_id\":\"8393c208-8b83-49eb-8c0b-0b50016e7401\",\n \"payment_method\":\"BANK_TRANSFER\",\n \"payment_channel\":\"PERMATA\"\n}"},"url":"{{mcp_url_v2_staging}}/va/inquiry","description":"Inquiry VA will show only the latest 5 transactions histories. The transactions history will be shown when the transaction is failed, or succeed only. You'll find more than one transaction history only on VA Feature type 2, 3 and 4 which supports multi use VA.
\nEndpoint for inquiry the transaction detail
\nRefer to the Securities section
\n"},{"key":"x-version","type":"text","value":"v3"}],"body":{"mode":"raw","raw":"{\n\"external_id\":\"{{extid}}\",\n\"order_id\":\"{{orderid}}\",\n\"transaction_id\":\"{{trx_id}}\",\n\"payment_method\":\"BANK_TRANSFER\",\n\"payment_channel\":\"{{channel}}\"\n}"},"url":"{{mcp_url_v2_staging}}/va/cancel","description":"Delete VA even after it being generated to your customer
\nVirtual Account allows merchants to issue invoice with unique ID, payable thru transfer via ATM and bank transfer. The unique ID for each transaction eases merchant’s reconciliation effort.
\n\n\n❗ Currently MC Payment supports BCA, BNI, BRI, Permata, CIMB,Mandiri , Finpay, and BNC Bank. We'll soon Supports BSI banks!
\n
Here the lists of virtual account channel that MC Payment supports:
\nMC Payment Virtual Account API supports close, open, partial amount payment. MCP also support the usage of static and dynamic Virtual Account number. Here's the features and logic board to set it up
\nReal Virtual Account usually requires you to put the number to ATM, or each bank platform, and pay with real money. Fear not, we understand that sometimes, you want to simulate the payment before going live.
\nMC Payment is providing you with an endpoint that simulate the Virtual Account Simulator and Voila, you have succeed the dummy payment for Virtual Account. Please refer this feature to the Virtual Account Simulator.
\nStandard response after receiving our callbacks should be returning HTTP/HTTPs Status 200.
\nOverlimit is a features that used on Open Payment VA only. Supported banks are Mandiri, BCA, BRI, CIMB, Permata *
\n\n\n","_postman_id":"b0d0442d-be78-4054-9cfc-f4374b192ace"},{"name":"Wallet V2","item":[{"name":"Create Payment Request (Direct App)","event":[{"listen":"prerequest","script":{"id":"3f4c9ded-af0d-4347-9481-ab44e817b2ff","exec":["var apikey=\"nIUkusILbNYxKzPI9NQq\";","var order_id = _.random(0, 99999999999999);","var external_id = _.random(0, 99999999999999);","var hashKey = \"ZfXJYBGuBICGRq6\";","","var signString = hashKey + external_id + order_id ","var signature = CryptoJS.SHA256(signString)","var signToSend = signature.toString(CryptoJS.enc.hex)","","postman.setEnvironmentVariable(\"signature\", signToSend)","console.log (\"signature\", signToSend)","postman.setEnvironmentVariable(\"order_id\", order_id)","console.log (\"order_id\", order_id)","postman.setEnvironmentVariable(\"external_id\", external_id)","console.log (\"external_id\", external_id)","",""],"type":"text/javascript"}}],"id":"8205d9ea-8963-4135-ba4b-c88ebc8a8a61","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"{{Authorization}}"},{"key":"x-req-signature","value":"{{x-req-signature}}","description":"*Coming soon
\n
Refer to the Securities section
\n"},{"key":"Content-Type","value":"application/json"},{"key":"x-version","value":"v3","type":"text"}],"body":{"mode":"raw","raw":"{ \n \"external_id\": \"{{merchant_unique_id}}\", \n \"order_id\": \"{{order_id}}\", \n \"currency\": \"IDR\", \n \"payment_method\": \"WALLET\", \n \"payment_channel\": \"{{channel_name: OVO/SHOPEEPAY/DANA/LINKAJA/VIRGO}}\", \n \"payment_details\": { \n \"amount\": {{amount}}, \n \"expired_time\": \"{{expired_time, e.g:2021-04-06T18:40:30.791+07:00}}\", \n \"transaction_description\": \"{{transaction_description}}\"\n }, \n \"customer_details\": {\n \"email\": \"{{customer_email}}\", \n \"full_name\": \"{{customer_full_name}}\", \n \"phone\": \"{{customer_phone_number}}\"\n },\n \"item_details\": [\n {\n \"item_id\": \"{{item_detail_id}}\",\n \"name\": \"{{item_detail_name}}\",\n \"amount\": {{item_detail_amount = item.amount * item.qty must match with payment_details.amount}},\n \"qty\": {{item_detail_qty}},\n \"description\": \"{{item_detail_description}}\"\n },\n {\n ....\n }\n ],\n \"wallet_details\": { \n \"id\": \"{{idvalue: customer_registered_HP}}\", \n \"id_type\": \"{{default_id_type}}\"\n }, \n \"payment_options\":{\n \"token\":\"{{access_token}}\" *only used for DANA account binding\n },\n \"billing_address\": {\n \"full_name\": \"{{customer_billing_full_name}}\",\n \"phone\": \"{{customer_billing_phone_number}}\",\n \"address\": \"{{customer_billing_address}}\",\n \"city\": \"{{customer_billing_city}}\",\n \"postal_code\": \"{{customer_billing_postalcode}}\",\n \"country\": \"{{customer_billing_indonesia}}\"\n },\n \"shipping_address\": {\n \"full_name\": \"{{customer_shipping_full_name}}\",\n \"phone\": \"{{customer_shipping_phone_number}}\",\n \"address\": \"{{customer_shipping_address}}\",\n \"city\": \"{{customer_shipping_city}}\",\n \"postal_code\": \"{{customer_shipping_postalcode}}\",\n \"country\": \"{{customer_shipping_indonesia}}\"\n },\n \"additional_data\": \"{{free text}}\",\n \"callback_url\": \"{{merchant_callback_url}}\",\n \"return_url\": \"{{merchant_returnpage_url}}\"\n} "},"url":"{{mcp_url_v2_staging}}/ewallet/v2/create-payment","description":"Create payment request is feature to generate payment link. This endpoint will give you payment link in the response JSON to pay customer transaction. Specifically for OVO, this feature is used to make payment requests that generate push notification payments to the OVO application. All channel will be happen in Asynchronous processing.
\nRefer to the Securities section
\n"},{"key":"Content-Type","value":"application/json"},{"key":"x-version","value":"v3","type":"text"}],"body":{"mode":"raw","raw":"{ \n \"external_id\": \"{{merchant_unique_id}}\", \n \"order_id\": \"{{order_id}}\", \n \"currency\": \"IDR\", \n \"payment_method\": \"{{payment_method_wallet}}\", \n \"payment_channel\": \"{{channel_name: SHOPEEPAY / NOBU / WECHAT_PAY / ALIPAY}}\", \n \"payment_system\":\"{{QR-OFFLINE/QR-ONLINE}}\",\n \"payment_details\": { \n \"amount\": {{amount}}, \n \"expired_time\": \"{{expired_time, e.g:2021-04-06T18:40:30.791+07:00}}\", \n \"transaction_description\": \"{{transaction_description}}\"\n }, \n \"customer_details\": {\n \"email\": \"{{customer_email}}\", \n \"full_name\": \"{{customer_full_name}}\", \n \"phone\": \"{{customer_phone_number}}\"\n },\n \"item_details\": [\n {\n \"item_id\": \"{{item_detail_id}}\",\n \"name\": \"{{item_detail_name}}\",\n \"amount\": {{item_detail_amount- item.amount * item.qty must match with payment_detail.amount}},\n \"qty\": {{item_detail_qty}},\n \"description\": \"{{item_detail_description}}\"\n },\n {\n ....\n }\n ],\n \"wallet_details\": { \n \"id\": \"{{idvalue}}\", \n \"id_type\": \"{{default_id_type}}\"\n }, \n \"billing_address\": {\n \"full_name\": \"{{customer_billing_full_name}}\",\n \"phone\": \"{{customer_billing_phone_number}}\",\n \"address\": \"{{customer_billing_address}}\",\n \"city\": \"{{customer_billing_city}}\",\n \"postal_code\": \"{{customer_billing_postalcode}}\",\n \"country\": \"{{customer_billing_indonesia}}\"\n },\n \"shipping_address\": {\n \"full_name\": \"{{customer_shipping_full_name}}\",\n \"phone\": \"{{customer_shipping_phone_number}}\",\n \"address\": \"{{customer_shipping_address}}\",\n \"city\": \"{{customer_shipping_city}}\",\n \"postal_code\": \"{{customer_shipping_postalcode}}\",\n \"country\": \"{{customer_shipping_indonesia}}\"\n },\n \"additional_data\": \"{{free text}}\",\n \"callback_url\": \"{{merchant_callback_url}}\"\n} "},"url":"{{mcp_url_v2_staging}}/ewallet/v2/create-qr","description":"Create a request payment to generate QR Content / QR Url image. This endpoint only support Dynamic QR.
\nFor Static QR, we will give you a QR which can be used for receiving payments. The setup is as easy as letting us know your callback url and the payment notification will be sent to there.
\nGenerate your access token to use DANA account binding. You have to keep the access token on your side. This process will remove 1 step, namely entering the HP number and PIN.
\nHow to get access token? you should hit endpoint oauth DANA and will get access token in token notify url. You must submit this Access token in payment_options.token to bypass this account binding process.
\nNote : One token only allows one phone number
\nRefer to the Securities section
\n"},{"key":"Content-Type","value":"application/json"},{"key":"x-version","value":"v3","type":"text"}],"body":{"mode":"raw","raw":"{\n \"transaction_id\": \"{{mcp_transaction_id}}\",\n \"external_id\": \"{{merchant_external_id}}\",\n \"order_id\": \"{{order_id}}\",\n \"payment_channel\": \"{{channel_name: OVO / SHOPEEPAY / NOBU / DANA / LINKAJA / VIRGO / WECHAT_PAY / ALIPAY}}\",\n \"payment_method\": \"{{payment_method_wallet}}\"\n}"},"url":"{{mcp_url_v2_staging}}/ewallet/v2/inquiry","description":"Endpoint for inquiry the transaction detail / transaction status.
\nRefer to the Securities section
\n","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"},{"key":"x-version","value":"v3","type":"text"}],"body":{"mode":"raw","raw":"{\n \"transaction_id\": \"{{mcp_transaction_id}}\",\n \"external_id\": \"{{merchant_external_id}}\",\n \"order_id\": \"{{order_id}}\",\n \"payment_channel\": \"{{channel_name: SHOPEEPAY / NOBU / WECHAT_PAY / ALIPAY}}\",\n \"payment_method\": \"{{payment_method_wallet}}\"\n}","options":{"raw":{"language":"json"}}},"url":"{{mcp_url_v2_staging}}/ewallet/v2/cancel-qr","description":"Cancel or close your QR even after it being generated to your customer if there some modified detail in your data / order by using this endpoint.
\nFor NOBU this feature only supports Dynamic QR.
\nRefer to the Securities section
\n"},{"key":"Content-Type","value":"application/json","type":"text"},{"key":"x-version","value":"v3","type":"text"}],"body":{"mode":"raw","raw":"{\n \"transaction_id\": \"{{mcp_transaction_id}}\",\n \"external_id\": \"{{merchant_external_id}}\",\n \"order_id\": \"{{order_id}}\",\n \"payment_method\": \"{{payment_method_wallet}}\",\n \"payment_channel\": \"{{channel_name: SHOPEEPAY}}\"\n\n}","options":{"raw":{"language":"json"}}},"url":"{{mcp_url_v2_staging}}/ewallet/v2/cancel-payment","description":"Cancel or close your payment link even after it being generated to your customer if there some modified detail in your data / order by using this endpoint.
\nThis feature only support for Shopeepay JumpApp.
\nRefer to the Securities section
\n"},{"key":"Content-Type","value":"application/json"},{"key":"x-version","value":"v3","type":"text"}],"body":{"mode":"raw","raw":"{\n \"transaction_id\": \"{{mcp_transaction_id}}\",\n \"external_id\": \"{{merchant_external_id}}\",\n \"order_id\": \"{{order_id}}\",\n \"payment_channel\": \"{{channel_name: SHOPEEPAY / NOBU / DANA / LINKAJA / VIRGO / WECHAT_PAY / ALIPAY}}\",\n \"payment_method\": \"{{payment_method_wallet}}\"\n}"},"url":"{{mcp_url_v2_staging}}/ewallet/v2/dummy-payment","description":"This Endpoint is only working and intended for Staging Environment only!
\nSimulate your payment and produce callback to your endpoint easily without real money testing and without any of our staff to help you, anytime.
\nFor NOBU this feature only support for Dynamic QR.
\nFor Wallet V2, Merchant now can just use attributes: transaction_status for the transaction overview, response_code, and response_message (for OVO) to update for the order status.
\nFor OVO, since MC Payment will also send the FAILED status in callback (Other channel like Shopeepay, DANA will only send SUCCESS, EXPIRED, REFUNDED/VOID callback), merchant can get the reason of failure from the response_message. This is only for case if OVO giving back the error validation. Otherwise, you can ignore response_message and just see if it success / reversed for OVO.
\nFor callbacks Refund and Void, the refund history and void history will be displayed.
\nSo the attributes JSON for OVO FAILED callback would be like this:
\n","urlObject":{"host":["{{merchant_callback_url}}"],"query":[],"variable":[]}},"response":[{"id":"a73d3f5f-4ac1-42b7-9d02-1a239ebf8762","name":"Notification Callback","originalRequest":{"method":"POST","header":[{"key":"mcp-signature","value":"123456123213213213145","type":"text"}],"body":{"mode":"raw","raw":"{\n \"transaction_id\": \"{{mcp_transaction_id}}\",\n \"external_id\": \"{{merchant_external_id}}\",\n \"order_id\": \"{{merchant_order_id}}\",\n \"merchant_id\": \"{{merchant_id}}\",\n \"reference_id\": \"{{transaction_reference_id}}\",\n \"currency\": \"IDR\",\n \"payment_method\": \"WALLET\",\n \"payment_channel\": \"{{channel, e.g: SHOPEEPAY, OVO, DANA, LINKAJA, NOBU, VIRGO, WECHAT_PAY, ALIPAY}}\",\n \"payment_system\": \"JUMPAPP\",\n \"transaction_status\": \"{{refer to transaction status table}}\",\n \"payment_details\": {\n \"amount\": {{payment_amount}},\n \"expired_time\": \"2021-04-28T10:21:20.163+07:00\",\n \"transaction_description\": \"{{trx_description}}\",\n \"transaction_time\": \"2021-04-28T10:06:20.592+07:00\",\n \"total_amount\": {{total_amount}},\n \"paid_time\": \"{{paid time, e.g: 2021-04-28T10:08:14.136+07:00}}\"\n },\n \"customer_details\": {\n \"phone\": \"{{customer_phone}}\",\n \"email\": \"{{customer_email}}\",\n \"full_name\": \"{{customer_fullname}}\"\n },\n \"item_details\": [\n {\n \"item_id\": \"{{item_id}}\",\n \"name\": \"{{item_name}}\",\n \"amount\": {{item_price}},\n \"qty\": {{item_qty}},\n \"description\": \"{{item_description}}\"\n }\n ],\n \"billing_address\": {\n \"phone\": \"{{billing_phone}}\",\n \"address\": \"{{billing_address}}\",\n \"city\": \"{{billing_city}}\",\n \"postal_code\": \"{{billing_postal_code}}\",\n \"country\": \"{{billing_country}}\",\n \"full_name\": \"{{billing_fullname}}\"\n },\n \"shipping_address\": {\n \"phone\": \"{{shipping_price}}\",\n \"address\": \"{{shipping_address}}\",\n \"city\": \"{{shipping_city}}\",\n \"postal_code\": \"{{shipping_postal_code}}\",\n \"country\": \"{{shipping_country}}\",\n \"full_name\": \"{{shipping_fullname}}\"\n },\n \"response_code\": \"{{refer to response code table}}\",\n \"issuer\": \"{{issuer_name, e.g: SHOPEEPAY, OVO, DANA, LINKAJA, NOBU}}\",\n \"additional_data\": \"{{free text}}\",\n \"wallet_details\": {\n \"id\": \"{{wallet_id_value}}\",\n \"id_type\": \"{{wallet_id_type}}\"\n },\n //Note : the type of payment that will be displayed is only the status PAID\n \"acquirer_issuer_relation\": \"{{on_us/off_us}}\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{merchant_callback_url}}?mcp-signature={{mcp-signature}}","host":["{{merchant_callback_url}}"],"query":[{"key":"mcp-signature","value":"{{mcp-signature}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"a53f2dcc-e9b3-464f-b63c-de628bdd30e2"},{"name":"Void","id":"c738ce8f-b76a-4072-806b-82b528034472","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Basic {{Base64encodedKey}}","type":"text"},{"key":"x-req-signature","value":"{{x-req-signature}}","type":"text","description":"Refer to the Securities section
\n"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"transaction_id\": \"{{mcp_transaction_id}}\",\n \"external_id\": \"{{merchant_external_id}}\",\n \"order_id\": \"{{order_id}}\",\n \"payment_channel\": \"{{channel_name: OVO/DANA}}\",\n \"payment_method\": \"WALLET\"\n}","options":{"raw":{"language":"json"}}},"url":"{{mcp_url_v2_staging}}/ewallet/v2/void","description":"Void will cancel your transaction. Void can be made for transactions that have been and have not been settled yet in the same date as the transaction.
\nEspecially for DANA, you can void transactions that have been paid or have not been paid.
\nOur API e-Wallet v2 basically is the latest improvement in the way you request and integrate with our e-wallet API, even better in the system improvement to enhance your integration process.
\nAPI e-Wallet V2 now support Authorization Basic & x-req-signature in Headers that will enhance your data security a lot compared to our V1, along with the external_id usage in body will guarantee that the data sent to us is yours, and the callback status for transaction is totally related to your data only.
\nHere the lists of EWallet channel that MC Payment supports:
\n","_postman_id":"84075a3d-47ad-4f84-a222-52916e111254"},{"name":"Payment Page","item":[{"name":"Generate Payment Page Link","event":[{"listen":"prerequest","script":{"id":"5b3d13d0-8781-4246-9caf-0dc70467f7d4","exec":["var crypto = require(\"crypto-js\");","","var apiKey = pm.environment.get(\"api_key\");","var secretKey = pm.environment.get(\"secret_key\");","var hashKey = pm.environment.get(\"hash_key\");","","function generateAuth(cred, order) {"," var hashKey = cred.hash_key;"," var orderId = order.order_id;"," var externalId = order.external_id;",""," var apiKey = cred.api_key;"," var secretKey = cred.secret_key;"," console.log(apiKey, secretKey);"," var _auth = apiKey + \":\" + secretKey;"," var __auth = Buffer.from(_auth).toString(\"base64\");"," var authBasic = \"Basic \" + __auth;"," var signature = crypto.SHA256(hashKey + externalId + orderId).toString();",""," pm.globals.set(\"order_id\", order.order_id);"," pm.globals.set(\"external_id\", order.external_id);"," pm.globals.set(\"basic_auth\", authBasic);"," pm.globals.set(\"signature\", signature);","}","","generateAuth({"," api_key: apiKey,"," secret_key: secretKey,"," hash_key: hashKey,","}, {"," order_id: Math.floor(Math.random()*10000).toString().padStart(5,\"0\"),"," external_id: Math.floor(Math.random()*10000).toString().padStart(5,\"0\"),","});"],"type":"text/javascript","packages":{}}}],"id":"0c7fd900-6884-4a7c-ac7e-183a3559346e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"{{Authorization}}","type":"text"},{"key":"x-req-signature","value":"{{x-req-signature}}","type":"text"},{"key":"sub-merchant-id","value":"{{optional. contact our support for usage}}","type":"text"},{"key":"x-version","value":"v3","type":"text"}],"body":{"mode":"raw","raw":"{\n \"order_id\": \"{{order_id}}\",\n \"external_id\": \"{{external_id}}\",\n \"amount\": {{amount, min: 15000 for all payment type }},\n \"description\": \"{{transaction_description}}\",\n \"contact_us\": {\n \"phone\" :\"{{contact_us_phone}}\"\n \"email\" :\"{{contact_us_email}}\"\n },\n \"customer_details\": {\n \"full_name\": \"{{customer_fullname}}\",\n \"email\": \"{{customer_email}}\",\n \"phone\": \"{{customer_phone}}\",\n \"address\": \"{{customer_address}}\",\n \"is_email_show\":\"{{default false. this variable used to show email customer on credit card transaction based on customer details}}\",\n \"is_phone_show\":\"{{default false. this variable used to show phone customer on credit card transaction based on customer details}}\",\n \"card_holder_name\": \"{{card_name}}\"\n },\n \"item_details\": [\n {\n \"item_id\": \"{{item_id}}\",\n \"name\": \"{{item_name}}\",\n \"amount\": {{item_price}},\n \"qty\": {{item_qty}}\n },\n {\n ....\n }\n ],\n \"selected_channels\": [\n {\"channel\":\"CARD\",\n \"acq\": \"{{please contact MCP for this value as the usage is depend on bank}}\"},\n\n {\"channel\":\"DANA\"},\n\n {\"channel\":\"OVO\"},\n\n {\"channel\":\"SHOPEEPAY\"},\n\n {\"channel\":\"LINKAJA\"},\n\n {\"channel\":\"QRIS\"},\n\n {\"channel\":\"OCTOCLICKS\"},\n\n {\"channel\":\"QR_OFFLINE/QR_ONLINE\",\n \"acq\": \"WECHAT_PAY\" and \"ALIPAY\"},\n\n {\"channel\": \"VA\",\n \"acq\": \"{{please contact MCP for this value as the usage is depend on bank}}\",\n \"payment_system\": \"CLOSED\",\n \"is_multi_use\": false}\n\n ],\n \"billing_address\": {\n \"full_name\": \"{{customer_billing_fullname}}\",\n \"phone\": \"{{customer_billing_phone}}\",\n \"address\": \"{{customer_billing_address}}\",\n \"city\": \"{{customer_billing_city}}\",\n \"postal_code\": \"{{customer_postal_code}}\",\n \"country\": \"{{customer_country_code, e.g: ID}}\"\n },\n \"shipping_address\": {\n \"full_name\": \"{{customer_shipping_fullname}}\",\n \"phone\": \"{{customer_shipping_phone}}\",\n \"address\": \"{{customer_shipping_address}}\",\n \"city\": \"{{customer_shipping_city}}\",\n \"postal_code\": \"{{customer_postal_code}}\",\n \"country\": \"{{customer_country_code, e.g: ID}}\"\n },\n \"save_card\": {{default false. this variable will be used in future}},\n \"callback_url\": \"{{merchant_callback_url}}\",\n \"success_redirect_url\": \"{{merchant_redirect_success_page_url}}\",\n \"failed_redirect_url\": \"{{merchant_redirect_failed_page_url}}\"\n}","options":{"raw":{"language":"json"}}},"url":"{{mcp_url_v2_staging}}/payment-page/payment","description":"Endpoint API to generate a payment page link to be shown on merchant webview / webpage. This endpoint will give you a payment_url in the response JSON, and you will need to show the payment_url or redirect customer in web page / web view
\nNote:
. Each channel may has their own limitation and preferences*\\. Please contact our admin / MRO, because merchant need to register and get the credential from bank first for this usage.
MCP API is returning the mcp-signature in header. This is the digital signature for your request. Always check and compare our mcp-signature header with your order signature first, to ensure that the callback is true and match with your order detail, before you update your transaction order status based on the callback value.
\nPlease make sure to always return these to MCP :
\nOur Notification Callback will retrying 3 times if the requirement above doesn't satisfied.
\nBelow is all the possible value of transaction_status that merchant can get on callback.
\nCreate a request to generate a payment page. Now merchant able to integrate Credit/Debit Card, E-Wallet (OVO, DANA, ShopeePay, LinkAja and VIRGO), Virtual Account, QRIS, WeChat Pay, Alipay and Direct Debit (OCTO Clicks), just using this one payment page API.
\nThis API is useful if merchant have no restriction with using payment page, and very recommended to those who use webview / html to show the payment page.
\nTesting Payment on Staging
\nStaging Environment can be used to create \"testing\" transactions (usually performed from your development/testing environment). All transaction made within this environment mode is not \"real\", and does not require \"real payment/fund\".
\nIn the Staging environment, we use web-based simulator to simulate a response from payment provider or bank's system. This helps to test different scenarios that can happen on production, without actually doing real payments.
\nThis is the list of payment that you can use on our Staging environment. Please note that, it will not work on Production environment. And please contact MCP team if you want to simulate paid transaction.
\nPayment category:
\n1.Card Payment
2.Virtual Account
3.E-Wallet
4.Direct Debit
\n\nⓘ Starting in API version 2, we encourage merchant to use the transaction status and response code to update your order status. We try our best to understand you, so you only need to map the response code as much as little, and only for what it matters.
\n
Below is all of the possible value of response message that merchant can get from OVO responses.
\nIn Version 2 of our service, we have:
\nE-Wallet Service! (Soon we'll change the product name to E-Money) which supports QRIS payment and also Jumpapp payment!.
\nMore Secured Credit Card* transactions, Dependable Fraud Detection System.
\nFront-end Payment Page that support Virtual Account, OTC (Pay Cash over the counter like Pegadaian, Pos), Credit Card, E-Wallet and QRIS payment.
\nBank Transfer (Virtual Account)** with 4 types of mode which configureable according your use case!.
\nTransaction Dashboard which monitor & exports your transaction real-time with no hassle and no API
\n\n\n*Available soon!
\n
Newest version of API implements :
\nAuthorization Basic Header
\nUsage of secure data signature. We will provide you Hash Key that only you know.
\nUnique external_id and it's all different to every merchant
\nCombination usage of hash key + external id + order_id to make sure all the data is send from merchant, and ultimately yours.
\nEvery 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
\nIn some cases, you may no need the expired notification status, so it depends on merchant to use and validated the expired callback.
\nNewest version of MCP API is returning the mcp-signature in header. This is the digital signature for your request. Always check and compare our mcp-signature header with your order signature first, to ensure that the callback is true and match with your order detail, before you update your transaction order status based on the callback value.
\nPlease make sure to always return Http Status Code 200 to MCP
\nOur Notification Callback will retrying 3 times if the requirement above doesn't satisfied.
\n\n\n","_postman_id":"6f8714ee-9479-4965-91f9-c3be35a73f68"},{"name":"Glossary","item":[],"id":"9893684a-1f1b-42ed-a9e9-161987e9db27","description":"","_postman_id":"9893684a-1f1b-42ed-a9e9-161987e9db27"}]}Data sent in Staging Environment will not trigger an actual purchase, MC Payment API provide dummy payment function for some channel to help you to simulate the payment process.
\n
ⓘ Whole service can be fully utilized in Production Environment.