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
  • Flow Permata CashOut
  • Flow CashOut Reservation
  • API Services
  • Transfer
  • Decrypting Cashout Code
  1. Merchant Integration
  2. API Reference
  3. SendMe
  4. Cash Out

ATM Permata Cash Out

PreviousCash OutNextAlfamart Cash Out

Last updated 7 months ago

Permata CashOut is one of the Faspay SendMe (disbursement) features that serve to conduct cash withdrawal transactions at Permata ATMs. The increasing number of money withdrawal options through Permata ATMs, could increase profit opportunities and expand market segmentation.

Flow Permata CashOut

Flow CashOut Reservation

API Services

Transfer

This service serves to create transactions from partner to Faspay. This service is used to process funds transfer from a partner account to a beneficiary.

Transfer Request

  • Relative URL : /account/API/transfer

  • Method : HTTP POST

The parameters that must be provided by the partner system to be accessed by the Faspay system are as follows:

Parameter
Data Type
Length
M/O/C
Description

virtual_account

Numeric

20

Mandatory

Virtual account number partner

beneficiary_bank_code

Alphanumeric

4

Mandatory

Beneficiary Bank Code

alf : Alfamart

Imr: Indomaret

C013: Permata CashOut

beneficiary_name

Alphanumeric

255

Mandatory

Beneficiary name

trx_no

Alphanumeric

255

Mandatory

Transaction number (from partner)

beneficiary_phone

Numeric

15

Mandatory

Beneficiary phone

trx_amount

Numeric

12

Mandatory

Total amount, ex : 100.000 - 150000000

Amount must be multiple of 100000.

callback_url

Alphanumeric

255

Mandatory

URL for callback/notification, used to notify the partner.

trx_desc

Alphanumeric

27

Mandatory

Description, If the user input is more than 27 characters, it will be cut into 27 characters

{ 
    "virtual_account" : 9920375800,
    "beneficiary_bank_code" : "C013",
    "beneficiary_name" : "Yudhistira",
    "trx_no" : "phpCAP20230828090142980",
    "beneficiary_phone" : "082306121011",
    "trx_amount" : "10000000",
    "callback_url" : "http://account-service/api/mail/sendtotele",
    "trx_desc" : "CAP28090142"

Transfer Response

Parameter
Data Type
Length
M/O/C
Description

virtual_account

Numeric

20

Mandatory

Virtual Account Number Partner

beneficiary_bank_code

Alphanumeric

4

Mandatory

Beneficiary Bank Code

alf: Alfamart

imr: Indomaret

C013: Permata CashOut

beneficiary_phone

Numeric

15

Mandatory

Beneficiary phone

trx_no

Numeric

255

Mandatory

Transaction number (from partner)

trx_date

Datetime (yyyy-mm-dd)

Mandatory

Transaction date time

trx_expired

Datetime (yyyy-mm-dd)

Mandatory

Transaction expired,

- null : expired date within 24 hours (depending on the partner)

instruct_date

Datetime (yyyy-mm-dd)

Mandatory

Transfer instruction date

trx_amount

Numeric

12

Mandatory

Total amount, ex : 100.000 - 150000000

Amount must be multiple of 100000.

trx_desc

Alphanumeric

27

Optional

Description, If the user input is more than 27 characters, it will be cut into 27 characters

callback_url

Alphanumeric

255

Mandatory

URL for callback/notification, used to notify the partner.

beneficiary_account_name

Alphanumeric

255

Mandatory

Beneficiary account name

trx_id

Numeric

16

Mandatory

ID Transaction

trx_reff

Alphanumeric

255

Mandatory

Reference of transaction number on system disbursement

cashout_code

Alphanumeric

255

Mandatory

Cashout code for the beneficiary to claim. The code will be encrypted using a private key generated by Faspay. So, partner need to decrypt the code using public key also generated by Faspay, before display or send it to beneficiary.

status

Numeric

1

Mandatory

List Status Transaction :

1 = On Process,

2 = Success,

4 = Failed,

5 = Reverse

message

Alphanumeric

255

Mandatory

Message Description

response_code

Numeric

2

Mandatory

Response code from bank (00 = success)

response_desc

Alphanumeric

255

Mandatory

Response description from bank

{
    "virtual_account": "9920375800",
    "beneficiary_bank_code": "C013",
    "beneficiary_name": "Yudhistira",
    "trx_no": "phpCAP20230828090142980",
    "beneficiary_phone": "082306121011",
    "trx_amount": 10000000,
    "callback_url": "http://account-service/api/mail/sendtotele",
    "trx_desc": "CAP28090142",
    "trx_date": "2023-08-28 09:01:43",
    "trx_expired": "2023-08-28 10:01:45",
    "instruct_date": "2023-08-28 09:01:43",
    "trx_id": 395855,
    "trx_reff": "i2oMlYLuzXsUgGC9cl0d_1693188104878866",
    "cashout_code": "CddMb0cKo8+dnvdTg1liAnlZiQP/u78U5echwhUxVAeVKKxiTOeqQPmS3NeEiqIGB+PZsJrGMSNkJJPu3c14EIOqlriUcw8VujqgzKCjfGno+7A89boQwmuqZdxwvIUHspdOXsdhajFR5rkmOrcPTvjvvalMT/7f7w7chzSM/Iqq+nHYgZFJz08J8bF7OIgG/V4W3eWn0NxCeYgA/pet/9hAv75d7g7LUzS2GYhNpOEHkQqHL6nWRd59I/KNSBCVmYKkFYSlwYV1NuflWoNRc4CvXa4rH8DzerPAlYhw7cAgFiI818/dks7ghiH13Vt1SPBLLe9zpZH1lZXA9a1wVw==",
    "status": "1",
    "message": "On Process",
    "response_code": "00",
    "response_desc": "success"
}

Decrypting Cashout Code

At transfer response, cashout_code that has been received by partner is in chipertext format, so partner need to decrypting the code using openssl_public_decrypt method to change the cashout_code into plain text. To decrypting the cashout_code into 10 digit plain text it can be done by the steps as follows:

  1. Partner receive public key from Faspay

  2. Decode the cashout_code using base64_decode method

  3. Decrypting the cashout_code using openssl_public_decrypt method and public key that has been partner received before

  4. Partner get 10 digit plain text of cashout_code

Sample Code Decrypting Cashout Code

public function dec_cashout_code($encrydata){
        $filename = "public.crt";
        $data = base64_decode($encrydata);
        $public_key = file_get_contents($filename, true);
        openssl_public_decrypt($data,$plaintext,$public_key);
        return $plaintext;
}