> For the complete documentation index, see [llms.txt](https://docs.faspay.co.id/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.faspay.co.id/merchant-integration/api-reference-1/sendme/cash-out/atm-permata-cash-out.md).

# ATM Permata Cash Out

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

<figure><img src="https://3692871117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHl0oXefaAKjpRLPnGw%2Fuploads%2FSSKlxlxgRiBFO5mEqw3Q%2Fpermata%20cashout.png?alt=media&amp;token=1710b802-2943-4d23-a08a-0c81bd62b2e3" alt=""><figcaption></figcaption></figure>

## 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:

{% tabs %}
{% tab title="Request Body" %}

<table><thead><tr><th width="290">Parameter</th><th width="169">Data Type</th><th width="93">Length</th><th width="148">M/O/C</th><th width="232">Description</th></tr></thead><tbody><tr><td>virtual_account</td><td>Numeric</td><td>20</td><td>Mandatory</td><td>Virtual account number partner</td></tr><tr><td>beneficiary_bank_code</td><td>Alphanumeric</td><td>4</td><td>Mandatory</td><td><p>Beneficiary Bank Code</p><p>alf : Alfamart</p><p>Imr: Indomaret</p><p>C013: Permata CashOut</p></td></tr><tr><td>beneficiary_name</td><td>Alphanumeric</td><td>255</td><td>Mandatory</td><td>Beneficiary name</td></tr><tr><td>trx_no</td><td>Alphanumeric</td><td>255</td><td>Mandatory</td><td>Transaction number (from partner)</td></tr><tr><td>beneficiary_phone</td><td>Numeric</td><td>15</td><td>Mandatory</td><td>Beneficiary phone</td></tr><tr><td>trx_amount</td><td>Numeric</td><td>12</td><td>Mandatory</td><td><p>Total amount, ex : 100.000 - 150000000</p><p>Amount must be multiple of 100000.</p></td></tr><tr><td>callback_url</td><td>Alphanumeric</td><td>255</td><td>Mandatory</td><td>URL for callback/notification, used to notify the partner.</td></tr><tr><td>trx_desc</td><td>Alphanumeric</td><td>27</td><td>Mandatory</td><td>Description, If the user input is more than 27 characters, it will be cut into 27 characters</td></tr></tbody></table>
{% endtab %}

{% tab title="Sample Request" %}

```json
{ 
    "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"

```

{% endtab %}
{% endtabs %}

#### Transfer Response

{% tabs %}
{% tab title="Response Body" %}

<table><thead><tr><th width="255">Parameter</th><th width="219">Data Type</th><th width="109">Length</th><th width="133">M/O/C</th><th width="282">Description</th></tr></thead><tbody><tr><td>virtual_account</td><td>Numeric</td><td>20</td><td>Mandatory</td><td>Virtual Account Number Partner</td></tr><tr><td>beneficiary_bank_code</td><td>Alphanumeric</td><td>4</td><td>Mandatory</td><td><p>Beneficiary Bank Code</p><p>alf: Alfamart</p><p>imr: Indomaret</p><p>C013: Permata CashOut</p></td></tr><tr><td>beneficiary_phone</td><td>Numeric</td><td>15</td><td>Mandatory</td><td>Beneficiary phone</td></tr><tr><td>trx_no</td><td>Numeric</td><td>255</td><td>Mandatory</td><td>Transaction number (from partner)</td></tr><tr><td>trx_date</td><td>Datetime (yyyy-mm-dd)</td><td> </td><td>Mandatory</td><td>Transaction date time</td></tr><tr><td>trx_expired</td><td>Datetime (yyyy-mm-dd)</td><td> </td><td>Mandatory</td><td><p>Transaction expired,</p><p>- null : expired date within 24 hours (depending on the partner)</p></td></tr><tr><td>instruct_date</td><td>Datetime (yyyy-mm-dd)</td><td> </td><td>Mandatory</td><td>Transfer instruction date</td></tr><tr><td>trx_amount</td><td>Numeric</td><td>12</td><td>Mandatory</td><td><p>Total amount, ex : 100.000 - 150000000</p><p>Amount must be multiple of 100000.</p></td></tr><tr><td>trx_desc</td><td>Alphanumeric</td><td>27</td><td>Optional</td><td>Description, If the user input is more than 27 characters, it will be cut into 27 characters</td></tr><tr><td>callback_url</td><td>Alphanumeric</td><td>255</td><td>Mandatory</td><td>URL for callback/notification, used to notify the partner.</td></tr><tr><td>beneficiary_account_name</td><td>Alphanumeric</td><td>255</td><td>Mandatory</td><td>Beneficiary account name</td></tr><tr><td>trx_id</td><td>Numeric</td><td>16</td><td>Mandatory</td><td>ID Transaction</td></tr><tr><td>trx_reff</td><td>Alphanumeric</td><td>255</td><td>Mandatory</td><td>Reference of transaction number on system disbursement</td></tr><tr><td>cashout_code</td><td>Alphanumeric</td><td>255</td><td>Mandatory</td><td>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.</td></tr><tr><td>status</td><td>Numeric</td><td>1</td><td>Mandatory</td><td><p>List Status Transaction :</p><p>1 = On Process,</p><p>2 = Success,</p><p>4 = Failed,</p><p>5 = Reverse</p></td></tr><tr><td>message</td><td>Alphanumeric</td><td>255</td><td>Mandatory</td><td>Message Description</td></tr><tr><td>response_code</td><td>Numeric</td><td>2</td><td>Mandatory</td><td>Response code from bank (00 = success)</td></tr><tr><td>response_desc</td><td>Alphanumeric</td><td>255</td><td>Mandatory</td><td>Response description from bank</td></tr></tbody></table>

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "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"
}
```

{% endtab %}
{% endtabs %}

## 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**

```xml
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;
}
```

|   |
| - |