Faspay
  • Homepage
  • Getting Started
    • Faspay Business
      • Debit Transaction
        • Features
          • Static Transaction
            • Virtual Account Static
          • UNIcount
      • Credit Card Transaction
        • Recurring Payment
    • Faspay Billing
      • Introduction
      • Feature
      • How To Use
        • Getting Started
        • Dashboard
        • Recipient
          • List Recipient
          • Recipient Group
          • Recurrence Status
        • Scheduled Status
        • Invoice
        • Report
        • Create Billing System
          • Single Billing
          • Mass Billing
        • Billing Setting
          • Reminder Setting
          • Template Setting
          • Invoice Status
    • Faspay Billing 2.0
      • How to Use
        • Getting Started
        • Billings
          • Billings List
            • Detail Billing
            • Upload Document
          • Scheduled Billing
          • Recurring Billing
          • Static VA Generator
            • Static VA Close Generator
            • Static VA Open Generator
            • Static VA List
            • Payment History
            • Excel File Template
        • Customers
          • Customer List
          • Customer Group
        • Reports
          • Invoice Issued
          • Payment History
          • Summary Outstanding
          • Detail Outstanding
          • Invoice Aging Report
          • Invoice Paid Report
          • Export Report
        • Items
          • Product Catalogs
          • Rooms
          • Product Category
          • UoM (Unit of Measurement)
        • E-Faktur
          • E-Faktur Range Number
            • Generate E-Faktur Number
            • Cancelation E-Faktur Number
          • Export CSV
          • E-Faktur Files
          • Setting Threshold E-Faktur
        • QR Business Profile
          • Create Business Profile
          • Business Profile List
          • Access Business Profile Page
          • Transaction History on Business Profile
            • Lite Sales App
        • Billing Settings
    • Faspay Xpress
      • Faspay Xpress 4.0
        • Setting Language
        • Payment Method
        • Quick Payment Guide
        • Send your Order Details and Payment Instructions
        • Payment Status
        • Payment Receipt
        • Rating Payment
      • Setting Xpress
    • Faspay SendMe
      • Introduction
      • Credentials
      • List Of Service API
      • Authentication
        • Header
        • Authorization
        • Signature
          • Generate signature token
          • Generate signature other service
          • HTTP Method
          • Relative URL
        • Request Body
        • Access Token
      • Cash Out
        • Alfamart Cash Out
        • Indomaret Cash Out
      • E-Wallet
    • SNAP
      • SNAP Direct Debit
      • SNAP QRIS
      • SNAP Virtual Account
      • SNAP Disbursement
  • Merchant Integration
    • API Reference
      • Debit
        • Payment Channel Inquiry
        • Post Data Transaction
        • Redirect Process
        • Inquiry Payment Status
        • Cancel Transaction
        • Payment Notification
        • URL Callback/Return URL
        • Reference
          • Status Response Code
          • Payment Channel Code
        • Bank Transfer Integration Guide
        • Internet Banking integration Guide
        • Retail Payment Integration Guide
        • Online Debit Integration Guide
          • B-secure
          • BRI Direct Debit
        • Online Credit Integration Guide
          • Status Response Code
        • e-Money Integration Guide
          • LinkAja Integration Guide
          • LinkAja QRIS Integration Guide
          • LinkAja AppLink Integration Guide
          • DANA Integration Guide
          • Sakuku Integration Guide
          • OVO Integration Guide
          • ShopeePay Jump App Integration Guide
          • ShopeePay QRIS Integration Guide
          • OVO Tokenize Integration Guide
          • DANA Subs Integration Guide
          • Paydia QRIS Integration Guide
        • Features
          • Static Transaction Integration
            • BNI VA Static Integration
            • BNC VA Static Integration
          • Unicount
        • Postman Collection
      • Credit Card
        • Payment Integration API
        • Additional API Integration
          • Inquiry Payment Status
          • Capture Transaction
          • Transaction Void
          • Refund Transaction
          • Signature Transaction
            • Generate Signature Request
            • Genarete signature response
          • Server CallBack / URL Notification Credit Card
          • API Tokenization
            • Payment Window Integration API
            • Payment Direct API
            • Advance Functionality API Tokenization
              • Inquiry Detail Token
              • Inquiry Delete Token
              • Inquiry Last Token (Dynamic Token Only)
        • Recurring Payment API
          • Message Flow Transaction
            • Post Transaction
            • Update Card
          • JSON Message Format
            • Update Member
            • Inquiry Status
            • Payment Notification
            • Notification CC Expired
          • Status Response Code
        • Response Transaction
          • Response Success
          • Response Failed
          • Response Code Error Transaction
          • User Notification Screen
        • Reference
          • Faspay e-Payment Error Code Listing - CC
          • Transaction Status - CC
          • End User Indicator (EUI)
          • Categories of User Code and User Message - CC
          • ECI
      • Xpress
        • Xpress Version 4🆕
      • Faspay Billing API
        • Create Billing
        • Inquiry Billing
        • Cancel Billing
        • Get List Invoice
        • Callback
      • SendMe
        • Register Account
        • Confirmation Register Account
        • Transfer
        • Inquiry Name
        • Inquiry Balance
        • Mutasi
        • Inquiry Status
        • Notification / Callback
        • Error Code And Response Code
        • APPENDIX
        • Cash Out
          • ATM Permata Cash Out
          • Alfamart Cash Out
          • Indomaret Cash Out
        • E-Wallet (Top Up)
          • Inquiry Name
          • Transfer (Top Up)
      • SNAP
        • Signature SNAP
        • SNAP Virtual Account
        • SNAP Direct Debit
        • SNAP QRIS
        • SNAP Disbursement
          • Response Code
      • Route Payment
        • Post Data Transaction
        • SNAP Generate QRIS
        • SNAP Create Virtual Account
        • SNAP Direct Debit
        • Inquiry Static VA
        • SNAP Inquiry Static VA
        • Response Code
    • E-Commerce Plugin
      • Woocommerce
      • Ecwid
  • SDK Integration
    • SendMe SDK
      • Integration with Java SDK
      • Integrate with PHP SDK
      • Integrate with Python SDK
  • BEFORE LIVE
    • Whitelist IP
    • Account Testing
    • Sample Code
  • AFTER LIVE
  • Merchant page Reference
    • Change Password
    • Dashboard
    • Transactions
      • Debit
      • Credit
      • Settlement
      • Notification
    • Settings Profile
    • Faspay Business
      • Credential Settings
      • Report Settings
        • Daily Report Settings
        • Daily Report
        • Resend Daily Report
      • Developer Settings
      • Route Payment
        • Transaction Report
        • History
    • Faspay SendMe
      • Google Authenticator Pairing
      • Disbursement Account
      • Withdrawal
      • Withdraw History
      • Single Transfer
      • Mass Transfer
        • Upload File
        • Validation
        • Mass Transfer
      • Transaction History
      • Paycheck
      • Top Up
      • Credential Settings
      • Report Settings
        • Daily Report
        • Daily Report Setting
        • Resend Daily Report
Powered by GitBook
On this page
  • Request Parameter
  • Sample Request
  • Response Parameter
  • Sample Response
  1. Merchant Integration
  2. API Reference
  3. Route Payment

Post Data Transaction

URL Endpoint Post Data

The endpoint URL is a feedback URL that will process the data in the post from the merchant system. For the implementation of the testing, UAT can use URL development.

Type
Environment
URL

XML

Development

JSON

Development

Request Parameter

The parameter that must be provide by the Merchant system to be accessed by the Faspay system are as follows:

Parameter
Data Type
M/O/C
Decription

request

Alphanumeric (50)

M

Request Description

merchant_id

Numeric (5)

M

Merchant Code From Faspay = BOI

merchant

Alphanumeric (32)

M

Merchant Name

bill_no

Alphanumeric (32)

M

Order Number

bill_reff

Alphanumeric (32)

O

Booking Number/reference (can fill same with order no)

bill_date

Datetime YYYY-MM-DD HH:MM:SS (19)

M

Transaction/ Order Date

bill_expired

Datetime YYYY-MM-DD HH:MM:SS (19)

M

Payment Expiring Date (max 30 days)

bill_desc

Alphanumeric (128)

M

Transaction Description

bill_currency

Alphanumeric (3)

M

Currency, Must be 'IDR'

bill_gross

Numeric (15)

O

Order Nominal

bill_tax

Numeric (15)

O

Billing tax

bill_miscfee

Numeric (15)

O

Miscellaneous fee

bill_total

Numeric (15)

M

Total Nominal

cust_no

Alphanumeric (32)

M

Customer Number

cust_name

Alphanumeric (128)

M

Customer Name

cust_lastname

Alphanumeric (128)

O

Customer Last name

payment_channel

Numeric (3)

M

pay_type

Alphanumeric (1)

M

Payment type :

  • 1: Full Settlement

  • 2: Installment

  • 3: Mixed 1 & 2

Pay Type 2 & 3 only implement on BCA KlikPay channel

bank_userid

Alphanumeric (128)

O

Customer User ID on bank’s services

msisdn

Numeric (64)

M

Customer Mobile Phone

email

Alphanumeric (128)

M

Customer Email

terminal

Numeric (16)

M

Always use 10 for Terminal

billing_name

Alphanumeric

C

Billing name for OVO

billing_lastname

Billing name

O

biling last name

billing_address

Alphanumeric (200)

O

Billing address

billing_address_city

Alphanumeric (50)

O

Billing City

billing_address_region

Alphanumeric (100)

O

Billing Addres Region

billing_address_state

Alphanumeric (100)

O

Billing Address State

billing_address_poscode

Alphanumeric (10)

O

Billing Address Pos Code

billing_msisdn

Numeric

C

Billing phone number

billing_address_country_code

Alphanumeric (10)

O

Billing Address Country Code

receiver_name_for_shipping

Alphanumeric (100)

C

Receiver Name

shipping_lastname

Alphanumeric

O

Receiver last name

shipping_address

Alphanumeric (200)

O

Shipping Address

shipping_address_city

Alphanumeric (50)

O

Shipping Address City

shipping_address_region

Alphanumeric (100)

O

Shipping Address Region

shipping_address_state

Alphanumeric (100)

O

Shipping Address State

shipping_address_poscode

Alphanumeric (10)

O

Shipping Address Pos Code

shipping_msisdn

Numeric

C

Shipping phone number

shipping_address_country_code

Alphanumeric (10)

O

Shipping Address Country Code

item

Array of Object

C

Item details

Notes:

  • Variable that contains in this parameter are customizeable, except Amount

  • This parameter is Mandatory for payment channel Akulaku, DanaSubs, Kredivo and BRICeria

product

Alphanumeric (50)

C

Item name

qty

Numeric (32)

C

Item quantity

amount

Numeric (15)

C

Item Price

tenor

Numeric (2)

C

Installment Tenor

  • 00: Full Payment

  • 03: 3 months

  • 6 months

  • 12: 12 months

Tenor 03,06,12 only use on BCA KlikPay channel

payment_plan

Numeric (1)

C

Payment plan

  • 1: Full Settlement

  • 2: Installement

merchant_id

Numeric (5)

C

Merchant Id From Payment Channel ex : MID from BCA KlikPay

reserve1

Alphanumeric (50)

O

reserve2

Alphanumeric (50)

C

route

Object

O

owner

Alphanumeric (32)

O

Registered partner id that owns/generates the transaction.

Notes:

  • 1 transaction only can contain 1 owner.

  • If null, then the remaining transaction amount will belong to the merchant’s Sendme balance.

partner_id

Alphanumeric (32)

O

Merchant partner id number.

partner_amount

Numeric (15)

C

Disbursement amount to partner.

signature

Alphanumeric (100)

M

sha1(md5(user_id merchant + password merchant + bill_no))

  • $signature : sha1(md5(($user_id.$pass.$bill_no)));

  • Sample signature: sha1(md5("bot310001p@ssw0rd310001zx")) = e0ba1b2dc29ab4cb4221df092f44b1c4e6f45c63


Sample Request

{
    "request": "Payment Details",
    "merchant_id": "99999",
    "merchant": "FASPAY STORE",
    "bill_no": "9333300199999123456",
    "bill_reff": "Abcd",
    "bill_date": "2024-09-11 10:00:00",
    "bill_expired": "2024-09-12 14:36:32",
    "bill_desc": "Gadget payment",
    "bill_currency": "IDR",
    "bill_gross": "0",
    "bill_tax": "0",
    "bill_miscfee": "0",
    "bill_total": "1000000",
    "cust_no": "1",
    "cust_name": "budi",
    "cust_lastname": "faspay",
    "payment_channel": "402",
    "pay_type": "1",
    "bank_userid": "",
    "msisdn": "08123123123",
    "email": "budi@gmail.com",
    "terminal": "10",
    "billing_name": "faspay",
    "billing_lastname": "0",
    "billing_address": "jalan pintu air raya",
    "billing_address_city": "Jakarta Pusat",
    "billing_address_region": "DKI Jakarta",
    "billing_address_state": "Indonesia",
    "billing_address_poscode": "10710",
    "billing_msisdn": "8766688686",
    "billing_address_country_code": "ID",
    "receiver_name_for_shipping": "Faspay",
    "shipping_lastname": "",
    "shipping_address": "jalan pintu air raya",
    "shipping_address_city": "Jakarta Pusat",
    "shipping_address_region": "DKI Jakarta",
    "shipping_address_state": "Indonesia",
    "shipping_address_poscode": "10710",
    "shipping_msisdn": "8766688686",
    "shipping_address_country_code": "ID",
    "item":
    [
        {
            "product": "Invoice",
            "qty": 1,
            "amount": 1000000,
            "tenor": 0,
            "payment_plan": 1,
            "merchant_id": "99999"
        }
    ],
    "reserve1": "0",
    "reserve2": "",
    "route":
    [
        {
            "owner": "26100253"
        },
        {
            "partner_id": "29195827",
            "partner_amount": "500000"
        },
        {
            "partner_id": "29200008",
            "partner_amount": "500000"
        }
    ],
    "signature": "ca1ed7300c72b8b14bc503826d0f54db8ed1a8b8"
}
<?xml version="1.0" encoding="UTF-8" ?>
 <faspay>
     <request>Payment Details</request>
     <merchant_id>99999</merchant_id>
     <merchant>FASPAY STORE</merchant>
     <bill_no>9333300199999123456</bill_no>
     <bill_reff>Abcd</bill_reff>
     <bill_date>2024-09-11 10:00:00</bill_date>
     <bill_expired>2024-09-12 14:36:32</bill_expired>
     <bill_desc>Gadget payment</bill_desc>
     <bill_currency>IDR</bill_currency>
     <bill_gross>0</bill_gross>
     <bill_tax>0</bill_tax>
     <bill_miscfee>0</bill_miscfee>
     <bill_total>1000000</bill_total>
     <cust_no>1</cust_no>
     <cust_name>budi</cust_name>
     <cust_lastname>faspay</cust_lastname>
     <payment_channel>402</payment_channel>
     <pay_type>1</pay_type>
     <bank_userid></bank_userid>
     <msisdn>08123123123</msisdn>
     <email>budi@gmail.com</email>
     <terminal>10</terminal>
     <billing_name>faspay</billing_name>
     <billing_lastname>0</billing_lastname>
     <billing_address>jalan pintu air raya</billing_address>
     <billing_address_city>Jakarta Pusat</billing_address_city>
     <billing_address_region>DKI Jakarta</billing_address_region>
     <billing_address_state>Indonesia</billing_address_state>
     <billing_address_poscode>10710</billing_address_poscode>
     <billing_msisdn>8766688686</billing_msisdn>
     <billing_address_country_code>ID</billing_address_country_code>
     <receiver_name_for_shipping>Faspay</receiver_name_for_shipping>
     <shipping_lastname></shipping_lastname>
     <shipping_address>jalan pintu air raya</shipping_address>
     <shipping_address_city>Jakarta Pusat</shipping_address_city>
     <shipping_address_region>DKI Jakarta</shipping_address_region>
     <shipping_address_state>Indonesia</shipping_address_state>
     <shipping_address_poscode>10710</shipping_address_poscode>
     <shipping_msisdn>8766688686</shipping_msisdn>
     <shipping_address_country_code>ID</shipping_address_country_code>
     <item>
         <product>Invoice</product>
         <qty>1</qty>
         <amount>1000000</amount>
         <tenor>0</tenor>
         <payment_plan>1</payment_plan>
         <merchant_id>99999</merchant_id>
     </item>
     <reserve1>0</reserve1>
     <reserve2></reserve2>
     <route>
         <owner>26100253</owner>
     </route>
     <route>
         <partner_id>29195827</partner_id>
         <partner_amount>500000</partner_amount>
     </route>
     <route>
         <partner_id>29200008</partner_id>
         <partner_amount>500000</partner_amount>
     </route>
     <signature>ca1ed7300c72b8b14bc503826d0f54db8ed1a8b8</signature>
 </faspay>

Response Parameter

Response parameters are parameters that will be delivered by Faspay system in response to the request that have been sent by the merchant system. If no parameters appropriate/value are incorrect, the transaction will be rejected in the system Faspay.

Parameter
Data Type
M/O/C
Description

response

Alphanumeric (50)

O

Response Name

trx_id

Numeric (16)

M

Transaction ID (Issued/generated by Faspay)

Notes: Unique Transaction ID for 1 day or if it hasn't been paid and hasn't expired

merchant_id

Numeric (5)

M

Merchant Code

merchant

Alphanumeric (32)

M

Merchant Name

bill_no

Alphanumeric (32)

M

Order No

external_id

Alphanumeric (16)

C

External id number

bill_item

Array of Object

C

Details item

Notes:

  • Variable that contains in this parameter are customizable, except Amount

  • This parameter is Mandatory for payment channel Akulaku, DanaSubs, Kredivo and BRICeria

product

Alphanumeric (50)

C

Item name

qty

Numeric (32)

C

Item quantity

amount

Numeric (15)

C

Item Price

tenor

Numeric (2)

C

Installment Tenor

  • 00: Full Payment

  • 03: 3 months

  • 06: 6 months

  • 12: 12 months

Tenor 03,06,12 only use on BCA KlikPay channel

payment_plan

Numeric (1)

C

Payment plan

  • 1: Full Settlement

  • 2: Installment

merchant_id

Numeric (5)

C

Merchant Id From Payment Channel

example: MID from BCA KlikPay

response_code

Numeric (2)

M

response_desc

Alphanumeric (32)

M

route

Object

O

owner

Alphanumeric (32)

O

Registered partner id that owns/generates the transaction.

Notes:

  • 1 transaction only can contain 1 owner.

  • If null, then the remaining transaction amount will belong to the merchant’s Sendme balance.

partner_id

Alphanumeric (32)

O

Merchant partner id number.

partner_amount

Numeric (15)

C

Disbursement amount to partner.

redirect_url

Alphanumeric

O

The redirect URL for the next process, available only on JSON format

Sample Response

{
    "response": "Payment Details",
    "trx_id": "8504999946414145",
    "merchant_id": "99999",
    "merchant": "FASPAY",
    "bill_no": "9333300199999123456",
    "external_id": "",
    "bill_item": [
        {
            "product": "Invoice",
            "qty": 1,
            "amount": 1000000,
            "tenor": 0,
            "payment_plan": 1,
            "merchant_id": "99999"
        }
    ],
    "response_code": "00",
    "response_desc": "Success",
    "route":
    [
        {
            "owner": "26100253"
        },
        {
            "partner_id": "29195827",
            "partner_amount": "500000"
        },
        {
            "partner_id": "29200008",
            "partner_amount": "500000"
        }
    ],
    "redirect_url": "https://debit-staging.faspay.co.id/pws/100003/0830000010100000/ca1ed7300c72b8b14bc503826d0f54db8ed1a8b8?trx_id=8504999946414145&merchant_id=99999&bill_no=9333300199999123456"
}
<?xml version="1.0" encoding="UTF-8" ?>
 <faspay>
     <response>Payment Details</response>
     <trx_id>8504999946414145</trx_id>
     <merchant_id>99999</merchant_id>
     <merchant>FASPAY</merchant>
     <bill_no>9333300199999123456</bill_no>
     <external_id></external_id>
     <bill_item>
         <product>Invoice</product>
         <qty>1</qty>
         <amount>1000000</amount>
         <tenor>0</tenor>
         <payment_plan>1</payment_plan>
         <merchant_id>99999</merchant_id>
     </bill_item>
     <response_code>00</response_code>
     <response_desc>Sukses</response_desc>
     <route>
         <owner>26100253</owner>
     </route>
     <route>
         <partner_id>29195827</partner_id>
         <partner_amount>500000</partner_amount>
     </route>
     <route>
         <partner_id>29200008</partner_id>
         <partner_amount>500000</partner_amount>
     </route>
     <redirect_url>https://debit-staging.faspay.co.id/pws/100003/0830000010100000/ca1ed7300c72b8b14bc503826d0f54db8ed1a8b8?trx_id=8504999946414145&merchant_id=99999&bill_no=9333300199999123456</redirect_url>
 </faspay>
PreviousRoute PaymentNextSNAP Generate QRIS

Last updated 6 months ago

Payment channel In details

Response Code. In details

Response Code Description. In details

https://debit-sandbox.faspay.co.id/pws/300011/183xx00010100000
https://debit-sandbox.faspay.co.id/cvr/300011/10
here.
here.
here.