Introduction

Welcome to MPAY Documentation API V4. Our API services are organized around REST, accepts form-encoded request bodies and returns JSON-encoded responses.

Authentication

MPAY API uses pair of API Key, API Token and IP Address to authenticate a partner request. Partner needs to register a unique IP Address which will be used as originating request for the API Services.

For Authorization on this api, API Key and Token are included in from request data:

HTTP(S) Request

API can be requested through HTTPS Request to MPAY API Base URL endpoint. The HTTPS Header has to be used to allow proper authentication, additionally HTTPS Request should only be made from IP Address which has been registered in MPAY.

Endpoint Url

Production : https://api-prod.mitrapayment.com/api/v4

Sanbox : Coomingsoon

Virtual Account

Use this API to create new VA number

Request Virtual Account

[PATH] : [URL_ENDPOINT]/va/{{payment_code}}

Example Request Virtual Account

<?php
$keyProject = 'MPI-xxxxxxxx';
$tokenProject = 'asdf12456789asfghjkl';

$paymentCode = "va_permata";

$amount = "10000";
$referenceId = "TEST_01";
$signHash = hash_hmac('sha512', $keyProject+$referenceId, $tokenProject);
$reqType = "oneoff";
$callbackUrl = "https://yourcallback.com/mpay";
$viewame = "Jhone Doe";
$expTime = "60";
$useCase = "single";
$vaExpired = "60";

$req_data = [
    'key' => $keyProject,
    'token' => $tokenProject,
    'referenceId' => $referenceId,
    'amount' => $amount,
    'callbackUrl' => $callbackUrl,
    'signHash' => $signHash,
    'reqType' => $reqType,
    'viewName' => $viewame,
    'expTime' => $expTime,
    'useCase' => $useCase,
    'vaExpired' => $vaExpired
];

$data_payload = json_encode($req_data);

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api-prod.mitrapayment.com/api/v4/va/'.$paymentCode,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => $data_payload,
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response Virtual Account

Response Request Virtual Account:

{
  "success": true,
  "data_payment": {
    "id": "MPI-ID-12345",
    "create_time": 1662549962,
    "status": "pending",
    "statustrx_time": 1662549962,
    "referenceId": "TEST_01",
    "paymentType": "receive",
    "paymentName": "VA Permata",
    "feeTo": "merchant",
    "Amount": "10000",
    "fee": 4500,
    "totalAmount": 10000,
    "callback": "https://yourcallback.com/mpay",
    "paymentMethod": {
      "trx_id": 12345,
      "trans_hash": "MPI-72cad731-5f43-45a7-bc2b-0799dd3daba3",
      "bank": "va_permata",
      "viewName": "Jhone Doe",
      "accountNo": "7392600003243381",
      "reqType": "oneoff",
      "useCase": "single",
      "paidCounter": 0
    }
  }
}

Payment Code Virtual Account

Bank Account Inquiry

Use this API to get beneficiary account details.

Request Bank Account Inquiry

[PATH] : [URL_ENDPOINT]/bank-account-inquiry/

Example Request Bank Account Inquiry

<?php
$keyProject = 'MPI-xxxxxxxx';
$tokenProject = 'asdf12456789asfghjkl';

$referenceId = "inquiry_test_01"; 
$accountNo = "123456789";
$bankShort = "BCA";

$req_data = [
    'key' => $keyProject,
    'token' => $tokenProject,
    'referenceId' => $referenceId,
    'accountNo' => $accountNo,
    'bankShort' => $bankShort,
];

$data_payload = json_encode($req_data);

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api-prod.mitrapayment.com/api/v4/bank-account-inquiry',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => $data_payload,
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

make sure the Authorization is correct and has become a base64 encoded string

Response Bank Account Inquiry

This Response If Bank Account Inquiry Success

{ 
    "status": true,
    "reffrenceId": "inquiry_test_01",
    "data": {
        "accountName": "John Doe",
        "accountNo": "123456789",
        "bankShort": "BCA",
        "bankCode": "014"
    }
}

Response Code Account Inquiry

if you look at the error_code response you can see Error Code Response , below is an addition to the inquiry account

{
    "success": false,
    "error_code": "INQUIRY_INVALID_ACCOUNT",
    "message": "Inquiry process is complete but the account number is invalid or maybe a virtual account number"
}

Disburstment

Use this API to start disbursing money to a specific beneficiary account.

Request Disburstment

[PATH] : [URL_ENDPOINT]/disburst/{{CHANNEL_CODE}}

Headers

Example Request Disburstment

<?php
$keyProject = 'MPI-xxxxxxxx';
$tokenProject = 'asdf12456789asfghjkl';

$channelCode = "disburst_c2";

$amount = "10000";
$referenceId = "DISBURST_REFF01";
$signHash = hash_hmac('sha512', $keyProject+$referenceId, $tokenProject);
$bankShort = "BCA";
$recipient_account = '123456789';
$callbackUrl = "https://yourcallback.com/mpay";


$req_data = [
    'key' => $keyProject,
    'token' => $tokenProject,
    'referenceId' => $referenceId,
    'signHash' => $signHash,
    'bankShort' => $bankShort,
    'recipient_account' => $recipient_account,
    'amount' => $amount,
    'useCase' => 'single',
    'paidCounter' => '1',
    'callbackUrl' => $callbackUrl
];

$data_payload = json_encode($req_data);

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api-prod.mitrapayment.com/api/v4/disburst/'.$channelCode,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => $data_payload,
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response Disburstment

This Response If Disbursement Success Created

Response Request Disburstment:

{
  "success": true,
  "data_payment": {
    "id": "MPI-ID-12345",
    "create_time": 1662566709,
    "status": "pending",
    "statustrx_time": 1662566709,
    "referenceId": "DISBURST_REFF01",
    "paymentType": "send",
    "Amount": "10000",
    "fee": 4500,
    "totalAmount": 14500,
    "callback": "https://yourcallback.com/mpay",
    "paymentMethod": {
      "trans_hash": "MPI-72cad731-5f43-45a7-bc2b-0799dd3daba3",
      "trxid_bank": "MPI-72cad731-5f43-45a7-bc2b-0799dd3daba3",
      "bankShort": "BCA",
      "recipient_name": "",
      "recipient_account": "123456789",
      "amount": "10000",
      "note": "",
      "email": "",
      "schedule_date": ""
    }
  }
}

Check Status Disburstment

Example Check Status Disburstment

<?php
$keyProject = 'MPI-xxxxxxxx';
$tokenProject = 'asdf12456789asfghjkl';

$channelCode = "disburst_c2";
$accountNo = "123456789";
$referenceId = "DISBURST_REFF01";

$req_data = [
    'key' => $keyProject,
    'token' => $tokenProject,
    'referenceId' => $referenceId,
    'accountNo' => $accountNo,
];

$data_payload = json_encode($req_data);

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api-prod.mitrapayment.com/api/v4/disburst_status/',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => $data_payload,
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

To get status of a disbursement request, you can call this API. You may need to call this API a few times until getting a final status (success/failed). We suggest to check the status after the remit API timed out or 60 seconds after the disbursement requested

This API offers an option to send you a callback status of the disbursement request to a specific URL.

Request Check Status Disburstment

[PATH] : [URL_ENDPOINT]/disburst_status/

You can use any of the above parameters

Response Check Status Disburstment:

{
    "success": true,
    "data_payment": [
        {
          "id": "MPI-ID-12345",
          "create_time": 1662566709,
          "status": "pending",
          "statustrx_time": 1662566709,
          "referenceId": "DISBURST_REFF01",
          "paymentType": "send",
          "Amount": "10000",
          "fee": 4500,
          "totalAmount": 14500,
          "callback": "https://yourcallback.com/mpay",
          "paymentMethod": {
            "trans_hash": "MPI-72cad731-5f43-45a7-bc2b-0799dd3daba3",
            "trxid_bank": "MPI-72cad731-5f43-45a7-bc2b-0799dd3daba3",
            "bankShort": "BCA",
            "recipient_name": "",
            "recipient_account": "123456789",
            "amount": "10000",
            "note": "",
            "email": "",
            "schedule_date": ""
          }
        }
    ]
}

List Bank Supported (bankShort)

Dynamic QRIS

This API will be used by partner to request Dynamic QRIS for payment.

Request Dynamic QRIS

[PATH] : [URL_ENDPOINT]/qris/created/

Example Request Dynamic QRIS

Example Check Status Disburstment

<?php
$keyProject = 'MPI-xxxxxxxx';
$tokenProject = 'asdf12456789asfghjkl';

$referenceId = "QRIS_REFF_01";
$signHash = hash_hmac('sha512', $keyProject+$referenceId, $tokenProject);
$amount = "10000";
$callbackUrl = "https://yourcallback.com/mpay";
$viewame = "Jhone Doe";
$expTime = "5";

$req_data = [
    'key' => $keyProject,
    'token' => $tokenProject,
    'referenceId' => $referenceId,
    'signHash' => $signHash,
    'amount' => $amount,
    'callbackUrl' => $callbackUrl,
    'viewName' => $viewName,
    'expTime' => $expTime
];

$data_payload = json_encode($req_data);

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api-prod.mitrapayment.com/api/v4/qris/created/',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => $data_payload,
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response Dynamic QRIS

This Response If Dynamic QRIS Success Created

Response Request E-Wallet:

{
  "success": true,
  "data_payment": {
    "id": "MPI-ID-1234567",
    "status": "pending",
    "referenceId": "QRIS_REFF_01",
    "paymentType": "receive",
    "paymentName": "Qris",
    "feeTo": "enduser",
    "amount": "10000",
    "fee": 70,
    "totalAmount": 10070,
    "callback": "https://yourcallback.com/mpay",
    "paymentDetail": {
      "imageQris": "https://api-prod.mitrapayment.com/get_images?id=MPI-7260e53f-8953-4c7b-a80c-4f0c5e7421a1",
      "contentQris": "00020101021226670016COM.NOBUBANK.WWW01189360050300000489870214081100000314640303UMI51440014ID.CO.QRIS.WWW0215ID20200814002040303UMI5204549953033605405100005802ID5913MITRA PAYMENT6015Banten - Kota T61052322362830114090800000426610525MPI-1a77dd9b-e4dd-4a08-8f0625MPI-1a77dd9b-e4dd-4a08-8f0703A01630487D6",
      "displayName": "Jhone Doe"
    }
  }
}

E-Wallet

E-Wallet Aggregator API allows partners / mitra to seamlessly charge and receive payments directly from top e-wallet issuers. With one integration, they are able to get access to all of OY’s available e-wallets ((OVO, ShopeePay, LinkAja, and DANA) and upcoming e-wallet integrations.

Request E-Wallet

[PATH] : [URL_ENDPOINT]/ewallet/created/{{E_WALLET_CODE}}

Example Request E-Wallet

<?php
$keyProject = 'MPI-xxxxxxxx';
$tokenProject = 'asdf12456789asfghjkl';

$e_walletCode = "dana";

$amount = "10000";
$referenceId = "ewallet_01";
$signHash = hash_hmac('sha512', $keyProject+$referenceId, $tokenProject);
$callbackUrl = "https://yourcallback.com/mpay";
$viewame = "Jhone Doe";
$expTime = "60";
$successRedirectUrl = "https://mitrapayment.com/REDIRECT";
$mobileNumber = "0811111111";

$req_data = [
    'key' => $keyProject,
    'token' => $tokenProject,
    'referenceId' => $referenceId,
    'amount' => $amount,
    'callbackUrl' => $callbackUrl,
    'signHash' => $signHash,
    'viewName' => $viewame,
    'successRedirectUrl' => $successRedirectUrl,
    'mobileNumber' => $mobileNumber,
    'expTime' => $expTime,
];

$data_payload = json_encode($req_data);

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api-prod.mitrapayment.com/api/v4/ewallet/created/'.$e_walletCode,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => $data_payload,
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response E-Wallet

This Response If E-Wallet Success Created

Response Request E-Wallet:

{
  "success": true,
  "data_payment": {
    "id": "MPI-ID-12456",
    "status": "pending",
    "referenceId": "ewallet_01",
    "paymentType": "receive",
    "paymentName": "DANA",
    "feeTo": "enduser",
    "amount": "10000",
    "fee": 250,
    "totalAmount": 10250,
    "callback": "https://yourcallback.com/mpay",
    "paymentDetail": {
      "trx_id": 12456,
      "trans_hash": "MPI-7260e53f-8953-4c7b-a80c-4f0c5e7421a1",
      "wallet": "dana",
      "viewName": "JHONDOE",
      "phone": "08111223344",
      "qrcode": "00020101021226680016COM.NOBUBANK.WWW011993600503000000309000214082200000002450303UBE51440014ID.CO.QRISWWW0215ID20190822000010303UBE520454995303360540450005502015802ID5925PT.MITRA PEMBAYARAN INDONESIA, JAKARTA610515811625301140822000022963305031230617201908221840560010703A0163042904",
      "checkout_url": "https://checkout.mitrapayment.com/success",
      "image_url": "https://api-prod.mitrapayment.com/get_images?id=MPI-7260e53f-8953-4c7b-a80c-4f0c5e7421a1"
    }
  }
}

E-Wallet Code

E-Wallet OVO Payment Link

We provide payment links for OVO as an alternative

Flow for the ovo payment link :

• Merchant request payment link OVO
• Merchant get response checkout url
• Merchant provides a checkout url to the enduser
• Enduser open a checkout url
• Enduser input mobile number / ovo number
• Enduser get notification for pay
• Enduser confirm pay
• Payment completed

[PATH] : [URL_ENDPOINT]/ewallet/payment_link/ovo

requests are the same as ewallets you can provide to this Request E-Wallet

the merchant provides a checkout url to the end user

Credit Card Link

This API will be used by partner to request Credit Card Link for payment.

Request Credit Card Link

[PATH] : [URL_ENDPOINT]/credit-card/request

Example Request Credit Card Link

<?php
$keyProject = 'MPI-xxxxxxxx';
$tokenProject = 'asdf12456789asfghjkl';

$amount = "10000";
$referenceId = "cc-reff-01";
$signHash = hash_hmac('sha512', $keyProject+$referenceId, $tokenProject);
$callbackUrl = "https://yourcallback.com/mpay";
$viewame = "Jhone Doe";
$expTime = "60";
$mobileNumber = "0811111111";

$req_data = [
    'key' => $keyProject,
    'token' => $tokenProject,
    'referenceId' => $referenceId,
    'amount' => $amount,
    'callbackUrl' => $callbackUrl,
    'signHash' => $signHash,
    'viewName' => $viewame,
    'mobileNumber' => $mobileNumber,
    'expTime' => $expTime,
];

$data_payload = json_encode($req_data);

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api-prod.mitrapayment.com/api/v4/credit-card/request',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => $data_payload,
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response Credit Card Link

This Response If Credit Card Link Success Created

Response Request Credit Card Link:

{
    "success": true,
    "data_payment": {
        "id": "MPI-f58c8ac8-38de-47a1-80fa-096448bed0a4",
        "status": "pending",
        "referenceId": "cc-reff-01",
        "paymentType": "receive",
        "paymentName": "Credit Card Link",
        "feeTo": "merchant",
        "amount": "10000",
        "fee": 6000,
        "totalAmount": 10000,
        "callback": "https://mitrapayment.com/callback",
        "paymentDetail": {
            "checkout_url": "https://pay.mitrapayment.com/7a3d34b0-6c97-4de0-be2b-24193b6e0c37",
            "customer_name": "Jhone Doe"
        }
    }
}

Retail Offline

Retail Offline enables your users to deposit money from Mpay channel such as Cash Recycle Machine (CRM) and convenience store.

Request Retail Offline

[PATH] : [URL_ENDPOINT]/retail/request/{{RETAIL_CHANNEL_CODE}}

Example Request Retail Offline

<?php
$keyProject = 'MPI-xxxxxxxx';
$tokenProject = 'asdf12456789asfghjkl';

$retail_cahnnel = "alfamart";

$amount = "10000";
$referenceId = "alfamart_01";
$signHash = hash_hmac('sha512', $keyProject+$referenceId, $tokenProject);
$callbackUrl = "https://yourcallback.com/mpay";
$viewame = "Jhone Doe";
$mobileNumber = "0811111111";

$req_data = [
    'key' => $keyProject,
    'token' => $tokenProject,
    'referenceId' => $referenceId,
    'signHash' => $signHash,
    'amount' => $amount,
    'callbackUrl' => $callbackUrl,
    'viewName' => $viewame,
    'mobileNumber' => $mobileNumber,
];

$data_payload = json_encode($req_data);

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api-prod.mitrapayment.com/api/v4/retail/request/'.$retail_cahnnel,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => $data_payload,
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response Retail Offline

This Response Success Created

Response Request E-Wallet:

{
    "success": true,
    "data_payment": {
        "id": "MPI-acb2b533-b1f1-4e2d-a8e2-f44199c3b7d4",
        "status": "pending",
        "referenceId": "alfamart_01",
        "paymentType": "receive",
        "paymentName": "ALFAMART",
        "feeTo": "merchant",
        "amount": "10000",
        "fee": 5000,
        "totalAmount": 10000,
        "callback": "https://yourcallback.com/mpay",
        "paymentDetail": {
            "payment_code": "428998053008",
            "expired_at": "2022-12-31 16:26:05.000"
        }
    }
}

Retail Offline Channel Code

Callback

Once the request is opened, our system will generate a request callback status to open the system to your system and will send it according to the callback_url

Callback Virtual Account

Example Callback Virtual Account

{
  "success": true,
  "data_payment": {
    "id": "MPI-ID-12345",
    "create_time": 1662549962,
    "status": "sukses",
    "statustrx_time": 1662549962,
    "referenceId": "TEST_01",
    "paymentType": "receive",
    "paymentName": "VA Permata",
    "feeTo": "merchant",
    "Amount": "10000",
    "fee": 4500,
    "totalAmount": 10000,
    "callback": "https://yourcallback.com/mpay",
    "paymentMethod": {
      "trx_id": 12345,
      "trans_hash": "MPI-72cad731-5f43-45a7-bc2b-0799dd3daba3",
      "bank": "va_permata",
      "viewName": "Jhone Doe",
      "accountNo": "7392600003243381",
      "reqType": "oneoff",
      "useCase": "single",
      "paidCounter": 0
    }
  }
}

Callback Disburstment

Example Callback Disburstment

{
  "success": true,
  "data_payment": {
    "id": "MPI-ID-12345",
    "create_time": 1662566709,
    "status": "sukses",
    "statustrx_time": 1662566709,
    "referenceId": "DISBURST_REFF01",
    "paymentType": "send",
    "Amount": "10000",
    "fee": 4500,
    "totalAmount": 14500,
    "callback": "https://yourcallback.com/mpay",
    "paymentMethod": {
      "trans_hash": "MPI-72cad731-5f43-45a7-bc2b-0799dd3daba3",
      "trxid_bank": "MPI-72cad731-5f43-45a7-bc2b-0799dd3daba3",
      "bankShort": "BCA",
      "recipient_name": "",
      "recipient_account": "123456789",
      "amount": "10000",
      "note": "",
      "email": "",
      "schedule_date": ""
    }
  }
}

Callback E-Wallet

Example Callback E-Wallet:

{
  "success": true,
  "data_payment": {
    "id": "MPI-ID-12456",
    "status": "sukses",
    "referenceId": "ewallet_01",
    "paymentType": "receive",
    "paymentName": "DANA",
    "feeTo": "enduser",
    "amount": "10000",
    "fee": 250,
    "totalAmount": 10250,
    "callback": "https://yourcallback.com/mpay",
    "paymentDetail": {
      "trx_id": 12456,
      "trans_hash": "MPI-7260e53f-8953-4c7b-a80c-4f0c5e7421a1",
      "wallet": "dana",
      "viewName": "JHONDOE",
      "phone": "08111223344",
      "qrcode": null,
      "checkout_url": "https://checkout.mitrapayment.com/success",
      "image_url": "https://api-prod.mitrapayment.com/get_images?id=MPI-7260e53f-8953-4c7b-a80c-4f0c5e7421a1"
    }
  }
}

Callback Credit Card Link

Example Callback Credit Card Link:

{
    "success": true,
    "data_payment": {
        "id": "MPI-f58c8ac8-38de-47a1-80fa-096448bed0a4",
        "status": "sukses",
        "referenceId": "cc-reff-01",
        "paymentType": "receive",
        "paymentName": "Credit Card Link",
        "feeTo": "merchant",
        "amount": "10000",
        "fee": 6000,
        "totalAmount": 10000,
        "callback": "https://mitrapayment.com/callback",
        "paymentDetail": {
            "checkout_url": "https://pay.mitrapayment.com/7a3d34b0-6c97-4de0-be2b-24193b6e0c37",
            "customer_name": "Jhone Doe"
        }
    }
}

Callback Retail Offline

Example Callback Retail Offline:

{
    "success": true,
    "data_payment": {
        "id": "MPI-acb2b533-b1f1-4e2d-a8e2-f44199c3b7d4",
        "status": "sukses",
        "referenceId": "alfamart_01",
        "paymentType": "receive",
        "paymentName": "ALFAMART",
        "feeTo": "merchant",
        "amount": "10000",
        "fee": 5000,
        "totalAmount": 10000,
        "callback": "https://yourcallback.com/mpay",
        "paymentDetail": {
            "payment_code": "428998053008",
            "expired_at": "2022-12-31 16:26:05.000"
        }
    }
}

Status Transaction

Error Response Code

{
    "success": false,
    "error_code": "API_AUTHORIZE_ERROR",
    "message": "You do not have authorization to access this API. Please provide personal access token from your account!"
}

Below is the list of response codes for API MPAY:

• API_AUTHORIZE_ERROR
• API_AUTHORIZE_ERROR
• API_PROJECT_ERROR
• API_WHITELIST_ERROR
• API_TOO_MANY_REQUEST_ERROR
• API_REQUEST_INVALID_ERROR
• API_SIGNHASH_INVALID_ERROR
• API_REFERENCEID_UNIQUE_ERROR
• API_TRX_NOT_FOUND_ERROR
• API_PAYMENT_NOT_FOUND_ERROR
• API_PAYMENT_MAINTENANCE_ERROR
• API_PAYMENT_INTERNAL_ERROR
• API_PAYMENT_ACCESS_ERROR
• API_PAYMENT_INACTIVE_ERROR
• API_PAYMENT_UNSUPPORT_ERROR
• API_BALANCE_INSUFFICIENT_ERROR
• API_BANKSHORT_INVALID_ERROR
• API_PAYMENT_TIMEOUT_FROM_BANK_ERROR
• API_PAYMENT_FAILED_CREATED_ERROR

Change Log

API VERSION 4.0

MPAY Changelog Documentation API

5 Jan 2023

• Add OVO Payment Link

30 Dec 2022

• Add Inquiry Account
• Add Retail (Alfamart)

08 Dec 2022

• Add Credit Card

08 Sept 2022

• Documentation API Created