POS Checkout

Information

PoS Checkout is a feature for confirming installment tenure and payment with Indodana BNPL

Path	/v1.0/bnpl/qr-checkout
HTTP Method	POST
Service Code	92
Type Format	JSON

Request Body

Parameter	Data Type	Mandatory	Length	Description
partnerReferenceNo	String	M	64	Transaction identifier is generated by the merchant and must be unique per request. Allowed alphanumeric and special characters -
paymentDetails	Object	M
paymentDetails.amount	Object	M
paymentDetails.amount.value	String	M	16,2	Total amount of customer’s transaction
paymentDetails.amount.currency	String	M	3
itemDetails	Array of Objects	M
itemDetails.itemId	String	M	64	Can be product SKU. For item fee such as: shipping fee, admin fee etc you have to use one of these: shippingfee, adminfee, taxfee, discount, additionalfee, insurancefee.
itemDetails.name	String	M	128	Product name
itemDetails.amount	Object	M		Product price
itemDetails.amount.value	String	M	16,2	If it's IDR then the value includes 2 decimal digits. e.g. IDR 10.000,- will be placed with 10000.00 with 2 decimal
itemDetails.amount.currency	String	M	3	Currency (Format: ISO4217), fixed value: IDR
itemDetails.category	enum	M	4	Category type of the product
itemDetails.qty	Integer	M	8	Quantity of the product
customerDetails	Object	M		Customer details
customerDetails.firstName	String	M	16	Customer’s first name
customerDetails.lastName	String	O	16	Customer’s last name
customerDetails.email	String	M	64	The customer’s email that is registered in the merchant site/platform
customerDetails.phone	String	M	16	The customer’s phone that is registered in the merchant site/platform
sellers	Array of Objects	O		Detail of the sellers. May contain more than 1 seller.
sellers.id	String	O	16	Seller’s ID
sellers.name	String	O	16	Seller’s name
sellers.url	String	O	256	Seller’s shop URL
sellers.sellerIdNumber	String	O	32	Seller’s identifier number (KTP / SIM / etc)
sellers.email	String	O	64	Seller’s email
sellers.address	Object	O		Seller’s address
sellers.address.firstName	String	M	16	Seller’s first name
sellers.address.lastName	String	O	16	Seller’s last name
sellers.address.address	String	M	256	Seller’s address
sellers.address.city	String	M	32	Seller’s city
sellers.address.postalCode	String	M	8	Seller’s postal code
sellers.address.phone	String	M	16	Seller’s phone number
sellers.address.countryCode	String	M	16	Seller’s country code, using ISO
callbackUrl	String	M	Merchant payment notification URL.
validityPeriod	String	O	The time when the payment is valid. Use format ISO-8601. Minimum and default expiry time is 15 minutes Maximum expiry time is 1x24 hours

Example Request

Details

cURL

curl --location 'https://api-stage.ifortepay.id/v1.1/bnpl/qr-checkout' \
--header 'Content-Type: application/json' \
--header 'X-TIMESTAMP: 2020-12-18T10:55:00+07:00' \
--header 'X-SIGNATURE: l/pk9PCr83BdMJ/r6RSRMxFk8kKt4vYPNwNy5PJl1p7Y9k0M+NijyFV97/MbyBtv4jO7FKbj83odFb32iYNyKnI/rai6QnovnoOBKSl3dg41sMb7RRediwt6JWa8VjFdkWaJQX4YGeP4SNG2QTT0ALAmL6fwr1pWi1V3fsPi73js1qNKbhEirCaT+o3uM8GKSreDnhWHDCSUWWMKHXAYGm68eOxLmUw1APqziHnYEFhbpv+kINX2zT94L2oi2AEIcVCl7UwZh/7ujf1oHj72GR30tvEyj6MTkGGTXNbkrH1aGd0BxuCwoU0JCme3bO34jjPInXlWTthNbeIbIdqwFQ==' \
--header 'X-PARTNER-ID: MC2025059906' \
--header 'X-EXTERNAL-ID: 69046731945362' \
--header 'CHANNEL-ID: PL001' \
--data-raw '{
    "partnerReferenceNo": "41199219261288",
    "paymentDetails": {
        "amount": {
            "value": "250000.00",
            "currency": "IDR"
        },
    },
    "itemDetails": [
        {
            "itemId": "FOOD01",
            "name": "RUJAK",
            "amount": {
                "value": "250000.00",
                "currency": "IDR"
            },
            "category": "0017",
            "qty": 1
        }
    ],
    "customerDetails": {
        "firstName": "Quality",
        "lastName": "Assurance",
        "email": "qa@ifortepay.id",
        "phone": "089121313131"
    },
    "sellers": [
        {
            "id": "123",
            "name": "Qa Tester",
            "url": "https://www.google.com/",
            "sellerIdNumber": "121313141",
            "email": "qa@ifortepay.id",
            "address": {
                "firstName": "Quality",
                "lastName": "Assurance",
                "address": "Jakarta",
                "city": "Jaksel",
                "postalCode": "testing9",
                "phone": "089121313131",
                "countryCode": "121313"
            }
        }
    ],
    "callbackUrl": "https://mcpid.proxy.beeceptor.com/BNPL",
    "validityPeriod": ""
}'

Go

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "https://api-stage.ifortepay.id/v1.1/bnpl/qr-checkout"
  method := "POST"

  payload := strings.NewReader(`{
    "partnerReferenceNo": "41199219261288",
    "paymentDetails": {
        "amount": {
            "value": "250000.00",
            "currency": "IDR"
        }
    },
    "itemDetails": [
        {
            "itemId": "FOOD01",
            "name": "RUJAK",
            "amount": {
                "value": "250000.00",
                "currency": "IDR"
            },
            "category": "0017",
            "qty": 1
        }
    ],
    "customerDetails": {
        "firstName": "Quality",
        "lastName": "Assurance",
        "email": "qa@ifortepay.id",
        "phone": "089121313131"
    },
    "sellers": [
        {
            "id": "123",
            "name": "Qa Tester",
            "url": "https://www.google.com/",
            "sellerIdNumber": "121313141",
            "email": "qa@ifortepay.id",
            "address": {
                "firstName": "Quality",
                "lastName": "Assurance",
                "address": "Jakarta",
                "city": "Jaksel",
                "postalCode": "testing9",
                "phone": "089121313131",
                "countryCode": "121313"
            }
        }
    ],
    "callbackUrl": "https://mcpid.proxy.beeceptor.com/BNPL",
    "validityPeriod": ""
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("X-TIMESTAMP", "2020-12-18T10:55:00+07:00")
  req.Header.Add("X-SIGNATURE", "l/pk9PCr83BdMJ/r6RSRMxFk8kKt4vYPNwNy5PJl1p7Y9k0M+NijyFV97/MbyBtv4jO7FKbj83odFb32iYNyKnI/rai6QnovnoOBKSl3dg41sMb7RRediwt6JWa8VjFdkWaJQX4YGeP4SNG2QTT0ALAmL6fwr1pWi1V3fsPi73js1qNKbhEirCaT+o3uM8GKSreDnhWHDCSUWWMKHXAYGm68eOxLmUw1APqziHnYEFhbpv+kINX2zT94L2oi2AEIcVCl7UwZh/7ujf1oHj72GR30tvEyj6MTkGGTXNbkrH1aGd0BxuCwoU0JCme3bO34jjPInXlWTthNbeIbIdqwFQ==")
  req.Header.Add("X-PARTNER-ID", "MC2025059906")
  req.Header.Add("X-EXTERNAL-ID", "69046731945362")
  req.Header.Add("CHANNEL-ID", "PL001")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

js

const axios = require('axios');
let data = JSON.stringify({
  "partnerReferenceNo": "41199219261288",
  "paymentDetails": {
    "amount": {
      "value": "250000.00",
      "currency": "IDR"
    }
  },
  "itemDetails": [
    {
      "itemId": "FOOD01",
      "name": "RUJAK",
      "amount": {
        "value": "250000.00",
        "currency": "IDR"
      },
      "category": "0017",
      "qty": 1
    }
  ],
  "customerDetails": {
    "firstName": "Quality",
    "lastName": "Assurance",
    "email": "qa@ifortepay.id",
    "phone": "089121313131"
  },
  "sellers": [
    {
      "id": "123",
      "name": "Qa Tester",
      "url": "https://www.google.com/",
      "sellerIdNumber": "121313141",
      "email": "qa@ifortepay.id",
      "address": {
        "firstName": "Quality",
        "lastName": "Assurance",
        "address": "Jakarta",
        "city": "Jaksel",
        "postalCode": "testing9",
        "phone": "089121313131",
        "countryCode": "121313"
      }
    }
  ],
  "callbackUrl": "https://mcpid.proxy.beeceptor.com/BNPL",
  "validityPeriod": ""
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api-stage.ifortepay.id/v1.1/bnpl/qr-checkout',
  headers: { 
    'Content-Type': 'application/json', 
    'X-TIMESTAMP': '2020-12-18T10:55:00+07:00', 
    'X-SIGNATURE': 'l/pk9PCr83BdMJ/r6RSRMxFk8kKt4vYPNwNy5PJl1p7Y9k0M+NijyFV97/MbyBtv4jO7FKbj83odFb32iYNyKnI/rai6QnovnoOBKSl3dg41sMb7RRediwt6JWa8VjFdkWaJQX4YGeP4SNG2QTT0ALAmL6fwr1pWi1V3fsPi73js1qNKbhEirCaT+o3uM8GKSreDnhWHDCSUWWMKHXAYGm68eOxLmUw1APqziHnYEFhbpv+kINX2zT94L2oi2AEIcVCl7UwZh/7ujf1oHj72GR30tvEyj6MTkGGTXNbkrH1aGd0BxuCwoU0JCme3bO34jjPInXlWTthNbeIbIdqwFQ==', 
    'X-PARTNER-ID': 'MC2025059906', 
    'X-EXTERNAL-ID': '69046731945362', 
    'CHANNEL-ID': 'PL001'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

php

<?php
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api-stage.ifortepay.id/v1.1/bnpl/qr-checkout',
  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 =>'{
    "partnerReferenceNo": "41199219261288",
    "paymentDetails": {
        "amount": {
            "value": "250000.00",
            "currency": "IDR"
        }
    },
    "itemDetails": [
        {
            "itemId": "FOOD01",
            "name": "RUJAK",
            "amount": {
                "value": "250000.00",
                "currency": "IDR"
            },
            "category": "0017",
            "qty": 1
        }
    ],
    "customerDetails": {
        "firstName": "Quality",
        "lastName": "Assurance",
        "email": "qa@ifortepay.id",
        "phone": "089121313131"
    },
    "sellers": [
        {
            "id": "123",
            "name": "Qa Tester",
            "url": "https://www.google.com/",
            "sellerIdNumber": "121313141",
            "email": "qa@ifortepay.id",
            "address": {
                "firstName": "Quality",
                "lastName": "Assurance",
                "address": "Jakarta",
                "city": "Jaksel",
                "postalCode": "testing9",
                "phone": "089121313131",
                "countryCode": "121313"
            }
        }
    ],
    "callbackUrl": "https://mcpid.proxy.beeceptor.com/BNPL",
    "validityPeriod": ""
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'X-TIMESTAMP: 2020-12-18T10:55:00+07:00',
    'X-SIGNATURE: l/pk9PCr83BdMJ/r6RSRMxFk8kKt4vYPNwNy5PJl1p7Y9k0M+NijyFV97/MbyBtv4jO7FKbj83odFb32iYNyKnI/rai6QnovnoOBKSl3dg41sMb7RRediwt6JWa8VjFdkWaJQX4YGeP4SNG2QTT0ALAmL6fwr1pWi1V3fsPi73js1qNKbhEirCaT+o3uM8GKSreDnhWHDCSUWWMKHXAYGm68eOxLmUw1APqziHnYEFhbpv+kINX2zT94L2oi2AEIcVCl7UwZh/7ujf1oHj72GR30tvEyj6MTkGGTXNbkrH1aGd0BxuCwoU0JCme3bO34jjPInXlWTthNbeIbIdqwFQ==',
    'X-PARTNER-ID: MC2025059906',
    'X-EXTERNAL-ID: 69046731945362',
    'CHANNEL-ID: PL001'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response

Parameter	Data Type	Mandatory	Length	Description
responseCode	String	M	7	Response code
responseMessage	String	M	150	Response description
partnerReferenceNo	String	M	64	ID transaction generated by the merchant
referenceNo	String	M	64	ID transaction generated by Ifortepay
paymentChannel	String	M	30	Description name payment channel
paymentDetails	Object	M
paymentDetails.amount	Object			Amount of the transaction
paymentDetails.amount.value	String	M	16,2
paymentDetails.amount.currency	String	M	3
paymentDetails.totalAmount	Object			Total amount of the transaction
paymentDetails.totalAmount.value	String	M	16,2	If it's IDR then value includes 2 decimal digits. e.g. IDR 10.000,- = 10000.00
paymentDetails.totalAmount.currency	String	M	3	Currency
qrContent	String	M		QR string
qrUrl	String	M		QR URL for downloading QR image
latestTransactionStatus	String	M	2	Refer to Appendix 1 - Transaction Status for specific transaction statuses
transactionStatusDesc	String	M	50	Description of transaction status
createdAt	String	M	25	Created time
validityPeriod	String	M

Example Response

Details

{
    "responseCode": "2009200",
    "responseMessage": "Successful",
    "partnerReferenceNo": "41199219261288",
    "referenceNo": "01970fb5-cd98-77f2-96c2-9ca28f5d83a4",
    "paymentChannel": "INDODANA",
    "paymentDetails": {
        "amount": {
            "value": "250000.00",
            "currency": "IDR"
        },
        "totalAmount": {
            "value": "250000.00",
            "currency": "IDR"
        }
    },
    "qrContent": "0002I101021226890015id.indodana.www011926f38e41-16b6-11f0-023626f38e41-16b6-11f0-b541-3f3594b467ec030326f5802ID5913Ifortepay POS62400136c181bdc3-3aa7-11f0-8b92-a12b471c87b0",
    "qrUrl": "https://storage.googleapis.com/com-indodanafinance-sandbox/offline/qr/c181bdc3-3aa7-11f0-8b92-a12b471c87b0.jpg?GoogleAccessId=offline-sandbox-signedurl@tmf-stg.iam.gserviceaccount.com&Expires=1748315863&Signature=ghZGj8XdMTli0KLr%2BqxCWUXgprw5NAfeBR8dDYTm4fB7HYVQbikMJkMIvgFm2ClIRrJzm%2B6jIvqsZexPwz9UjDcc28YFnVxcnX%2BjyZz8WhLjj7mGAC5itg0kSeh0y8OfPOm3hhuH2CRvqe0ZPXJpOChiHMYdWbxTr25maOvPugFqoPaw6npEInqlXz9uGktTxKp6%2BFLtV5ckVkCN%2FORGS9rZR5UC4Da0HcVmJ4enR931tPrv7szfq1P%2FhkmXC7k9A2L5rpEAqWCvjwjaaL0kPBMl9Huyi0Fvsjei3zO4xL8ALwBOjuSm%2F%2F213eWGzpApBfHOK%2BlofG2H7cWq%2BuTCHA%3D%3D",
    "latestTransactionStatus": "01",
    "transactionStatusDesc": "Initiated",
    "createdAt": "2025-05-27T10:07:43+07:00",
    "validityPeriod": "2025-05-27T10:22:42+07:00"
}