Notification Callback VA PG3

Information

Hostname	{ merchant_callback_url }
HTTP Method	POST

Headers

Key	Format	Required	Value
Content-Type	application/json	M
mcp-signature	String	M	{ mcp-signature }

Example

Body raw

{
    "transaction_id": "{{mcp_transaction_id}}",
    "external_id": "{{merchant_external_id}}",
    "order_id": "{{merchant_order_id}}",
    "reference_id": "{{transaction_reference_id}}",
    "currency": "IDR",
    "payment_method": "BANK_TRANSFER",
    "payment_channel": "{{channel, e.g: BRI, MANDIRI, BCA, etc}}",
    "payment_system": "{{e.g : OPEN, CLOSED, PARTIAL}}",
    "transaction_status": "{{refer to transaction status table}}",
    "transaction_time": "2021-04-28T10:06:20.592+07:00",
    "payment_details": {
        "amount": {{payment_amount}},
        "expired_time": "2021-04-28T10:21:20.163+07:00",
        "transaction_description": "{{trx_description}}",
        "total_amount": {{total_amount}},
        "paid_time": "{{paid time, e.g: 2021-04-28T10:08:14.136+07:00}}"
    },
    "customer_details": {
        "phone": "{{customer_phone}}",
        "email": "{{customer_email}}",
        "full_name": "{{customer_fullname}}"
    },
    "item_details": [
        {
            "item_id": "{{item_id}}",
            "name": "{{item_name}}",
            "amount": {{item_price}},
            "qty": {{item_qty}},
            "description": "{{item_description}}"
        }
    ],
    "billing_address": {
        "phone": "{{billing_phone}}",
        "address": "{{billing_address}}",
        "city": "{{billing_city}}",
        "postal_code": "{{billing_postal_code}}",
        "country": "{{billing_country}}",
        "full_name": "{{billing_fullname}}"
    },
    "shipping_address": {
        "phone": "{{shipping_price}}",
        "address": "{{shipping_address}}",
        "city": "{{shipping_city}}",
        "postal_code": "{{shipping_postal_code}}",
        "country": "{{shipping_country}}",
        "full_name": "{{shipping_fullname}}"
    },
    "response_code": "{{refer to response code table}}",
    "issuer": "{{issuer_name, e.g: BCA, BNI, BRI, .etc. Note : only shown on transactions whose status is paid}} ",
    "additional_data": "{{free text}}",
    //Note: refund_history will be displayed only on refunded status
    "refund_history": [
        {
        "refund_time": "2022-03-11T14:31:20.939+07:00",
        "refund_amount": 1000
        }
    ],
    //Note: void_history will be displayed only on void status
    "payment_history":[	
        {	
            "paid_amount":{{paid_amount}},	
            "paid_time":"{{paid_time, e.g: 2021-04-28T10:08:14.136+07:00}}",	
            "reference_id":"{{reference_id}}"	
        }	
    ],
    "transaction_type":"on_us" // on_us || off_us for identify transaction after payment 
}

Example Request

curl

curl --location -g '{{merchant_callback_url}}' \
--header 'mcp-signature: {{mcp-signature}}' \
--data '{	
   "response_code":"00",	
   "transaction_id":"{{mcp_transaction_id}}",	
   "external_id":"{{merchant_external_id}}",	
   "order_id":"{{merchant_order_id}}",	
   "currency":"IDR",	
   "transaction_status":"{{refer to transaction status table}}",	
   "transaction_time":"{{transaction time, e.g: 2021-04-28T10:08:14.136+07:00}}",	
   "payment_method":"BANK_TRANSFER",	
   "payment_channel":"{{channel, e.g: BNI, BRI, BCA, MANDIRI, etc}}",	
   "additional_data":"{{additional_data}}",	
   "callback_url":"{{callback_url_merchant}}",	
   "customer_details":{	
      "email":"{{email}}",	
      "full_name":"{{full_name}}",	
      "phone":"{{phone}}"	
   },	
   "item_details":[	
      {	
         "item_id":"{{item_id}}",	
         "name":"{{item_name}}",	
         "amount":{{amount_of_item}},	
         "qty":{{quantity_item}},	
         "description":"{{item_description}}"	
      }	
   ],
   //Note : payment_history will be display only if transaction has been paid	
   "payment_history":[	
      {	
         "paid_amount":{{paid_amount}},	
         "paid_time":"{{paid_time, e.g: 2021-04-28T10:08:14.136+07:00}}",	
         "reference_id":"{{reference_id}}"	
      }	
   ],	
   "payment_details":{	
      "payment_system":"{{ex : CLOSED,OPEN,PARTIAL}}",	
      "billing_name":"{{billing_name}}",	
      "va_number":"{{va_number}}",	
      "amount":{{amount}},	
      "total_fee_amount":{{total_fee_amount}},	
      "total_promo_amount":{{total_promo_amount}},	
      "total_amount":{{total_amount}},	
      "total_paid_amount":{{total_paid_amount}},	
      "is_multi_use":{{true/false}},	
      "is_customer_paying_fee":{{true/false}},	
      "expired_time":"expired_time, e.g: 2021-04-28T10:08:14.136+07:00",	
      "transaction_description":"{{transaction_description}}"	
   },	
   "billing_address": {
        "phone": "{{billing_phone}}",
        "address": "{{billing_address}}",
        "city": "{{billing_city}}",
        "postal_code": "{{billing_postal_code}}",
        "country": "{{billing_country}}",
        "full_name": "{{billing_fullname}}"
    },
    "shipping_address": {
        "phone": "{{shipping_price}}",
        "address": "{{shipping_address}}",
        "city": "{{shipping_city}}",
        "postal_code": "{{shipping_postal_code}}",
        "country": "{{shipping_country}}",
        "full_name": "{{shipping_fullname}}"
    },
    "response_code": "{{refer to response code table}}",
    "issuer": "{{issuer_name, e.g: BRI, BCA, Mandiri, .etc}}",
    "additional_data": "{{free text}}"
}'

go

package main
import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)
func main() {
  url := "{{merchant_callback_url}}"
  method := "POST"
  payload := strings.NewReader(`{	
   "response_code":"00",	
   "transaction_id":"{{mcp_transaction_id}}",	
   "external_id":"{{merchant_external_id}}",	
   "order_id":"{{merchant_order_id}}",	
   "currency":"IDR",	
   "transaction_status":"{{refer to transaction status table}}",	
   "transaction_time":"{{transaction time, e.g: 2021-04-28T10:08:14.136+07:00}}",	
   "payment_method":"BANK_TRANSFER",	
   "payment_channel":"{{channel, e.g: BNI, BRI, BCA, MANDIRI, etc}}",	
   "additional_data":"{{additional_data}}",	
   "callback_url":"{{callback_url_merchant}}",	
   "customer_details":{	
      "email":"{{email}}",	
      "full_name":"{{full_name}}",	
      "phone":"{{phone}}"	
   },	
   "item_details":[	
      {	
         "item_id":"{{item_id}}",	
         "name":"{{item_name}}",	
         "amount":{{amount_of_item}},	
         "qty":{{quantity_item}},	
         "description":"{{item_description}}"	
      }	
   ],
   //Note : payment_history will be display only if transaction has been paid	
   "payment_history":[	
      {	
         "paid_amount":{{paid_amount}},	
         "paid_time":"{{paid_time, e.g: 2021-04-28T10:08:14.136+07:00}}",	
         "reference_id":"{{reference_id}}"	
      }	
   ],	
   "payment_details":{	
      "payment_system":"{{ex : CLOSED,OPEN,PARTIAL}}",	
      "billing_name":"{{billing_name}}",	
      "va_number":"{{va_number}}",	
      "amount":{{amount}},	
      "total_fee_amount":{{total_fee_amount}},	
      "total_promo_amount":{{total_promo_amount}},	
      "total_amount":{{total_amount}},	
      "total_paid_amount":{{total_paid_amount}},	
      "is_multi_use":{{true/false}},	
      "is_customer_paying_fee":{{true/false}},	
      "expired_time":"expired_time, e.g: 2021-04-28T10:08:14.136+07:00",	
      "transaction_description":"{{transaction_description}}"	
   },	
   "billing_address": {
        "phone": "{{billing_phone}}",
        "address": "{{billing_address}}",
        "city": "{{billing_city}}",
        "postal_code": "{{billing_postal_code}}",
        "country": "{{billing_country}}",
        "full_name": "{{billing_fullname}}"
    },
    "shipping_address": {
        "phone": "{{shipping_price}}",
        "address": "{{shipping_address}}",
        "city": "{{shipping_city}}",
        "postal_code": "{{shipping_postal_code}}",
        "country": "{{shipping_country}}",
        "full_name": "{{shipping_fullname}}"
    },
    "response_code": "{{refer to response code table}}",
    "issuer": "{{issuer_name, e.g: BRI, BCA, Mandiri, .etc}}",
    "additional_data": "{{free text}}"
}`)
  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)
  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("mcp-signature", "{{mcp-signature}}")
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()
  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

js

var axios = require('axios');
var data = '{\t\n   "response_code":"00",\t\n   "transaction_id":"{{mcp_transaction_id}}",\t\n   "external_id":"{{merchant_external_id}}",\t\n   "order_id":"{{merchant_order_id}}",\t\n   "currency":"IDR",\t\n   "transaction_status":"{{refer to transaction status table}}",\t\n   "transaction_time":"{{transaction time, e.g: 2021-04-28T10:08:14.136+07:00}}",\t\n   "payment_method":"BANK_TRANSFER",\t\n   "payment_channel":"{{channel, e.g: BNI, BRI, BCA, MANDIRI, etc}}",\t\n   "additional_data":"{{additional_data}}",\t\n   "callback_url":"{{callback_url_merchant}}",\t\n   "customer_details":{\t\n      "email":"{{email}}",\t\n      "full_name":"{{full_name}}",\t\n      "phone":"{{phone}}"\t\n   },\t\n   "item_details":[\t\n      {\t\n         "item_id":"{{item_id}}",\t\n         "name":"{{item_name}}",\t\n         "amount":{{amount_of_item}},\t\n         "qty":{{quantity_item}},\t\n         "description":"{{item_description}}"\t\n      }\t\n   ],\n   //Note : payment_history will be display only if transaction has been paid\t\n   "payment_history":[\t\n      {\t\n         "paid_amount":{{paid_amount}},\t\n         "paid_time":"{{paid_time, e.g: 2021-04-28T10:08:14.136+07:00}}",\t\n         "reference_id":"{{reference_id}}"\t\n      }\t\n   ],\t\n   "payment_details":{\t\n      "payment_system":"{{ex : CLOSED,OPEN,PARTIAL}}",\t\n      "billing_name":"{{billing_name}}",\t\n      "va_number":"{{va_number}}",\t\n      "amount":{{amount}},\t\n      "total_fee_amount":{{total_fee_amount}},\t\n      "total_promo_amount":{{total_promo_amount}},\t\n      "total_amount":{{total_amount}},\t\n      "total_paid_amount":{{total_paid_amount}},\t\n      "is_multi_use":{{true/false}},\t\n      "is_customer_paying_fee":{{true/false}},\t\n      "expired_time":"expired_time, e.g: 2021-04-28T10:08:14.136+07:00",\t\n      "transaction_description":"{{transaction_description}}"\t\n   },\t\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: BRI, BCA, Mandiri, .etc}}",\n    "additional_data": "{{free text}}"\n}';
var config = {
  method: 'post',
maxBodyLength: Infinity,
  url: '{{merchant_callback_url}}',
  headers: { 
    'mcp-signature': '{{mcp-signature}}'
  },
  data : data
};
axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

php

use GuzzleHttp\Client;

$client = new Client();
$headers = [
  'mcp-signature' => '{{mcp-signature}}'
];
$body = '{	
   "response_code":"00",	
   "transaction_id":"{{mcp_transaction_id}}",	
   "external_id":"{{merchant_external_id}}",	
   "order_id":"{{merchant_order_id}}",	
   "currency":"IDR",	
   "transaction_status":"{{refer to transaction status table}}",	
   "transaction_time":"{{transaction time, e.g: 2021-04-28T10:08:14.136+07:00}}",	
   "payment_method":"BANK_TRANSFER",	
   "payment_channel":"{{channel, e.g: BNI, BRI, BCA, MANDIRI, etc}}",	
   "additional_data":"{{additional_data}}",	
   "callback_url":"{{callback_url_merchant}}",	
   "customer_details":{	
      "email":"{{email}}",	
      "full_name":"{{full_name}}",	
      "phone":"{{phone}}"	
   },	
   "item_details":[	
      {	
         "item_id":"{{item_id}}",	
         "name":"{{item_name}}",	
         "amount":{{amount_of_item}},	
         "qty":{{quantity_item}},	
         "description":"{{item_description}}"	
      }	
   ],
   //Note : payment_history will be display only if transaction has been paid	
   "payment_history":[	
      {	
         "paid_amount":{{paid_amount}},	
         "paid_time":"{{paid_time, e.g: 2021-04-28T10:08:14.136+07:00}}",	
         "reference_id":"{{reference_id}}"	
      }	
   ],	
   "payment_details":{	
      "payment_system":"{{ex : CLOSED,OPEN,PARTIAL}}",	
      "billing_name":"{{billing_name}}",	
      "va_number":"{{va_number}}",	
      "amount":{{amount}},	
      "total_fee_amount":{{total_fee_amount}},	
      "total_promo_amount":{{total_promo_amount}},	
      "total_amount":{{total_amount}},	
      "total_paid_amount":{{total_paid_amount}},	
      "is_multi_use":{{true/false}},	
      "is_customer_paying_fee":{{true/false}},	
      "expired_time":"expired_time, e.g: 2021-04-28T10:08:14.136+07:00",	
      "transaction_description":"{{transaction_description}}"	
   },	
   "billing_address": {
        "phone": "{{billing_phone}}",
        "address": "{{billing_address}}",
        "city": "{{billing_city}}",
        "postal_code": "{{billing_postal_code}}",
        "country": "{{billing_country}}",
        "full_name": "{{billing_fullname}}"
    },
    "shipping_address": {
        "phone": "{{shipping_price}}",
        "address": "{{shipping_address}}",
        "city": "{{shipping_city}}",
        "postal_code": "{{shipping_postal_code}}",
        "country": "{{shipping_country}}",
        "full_name": "{{shipping_fullname}}"
    },
    "response_code": "{{refer to response code table}}",
    "issuer": "{{issuer_name, e.g: BRI, BCA, Mandiri, .etc}}",
    "additional_data": "{{free text}}"
}';
$request = new Request('POST', '{{merchant_callback_url}}', $headers, $body);
$res = $client->sendAsync($request)->wait();
echo $res->getBody();