> For the complete documentation index, see [llms.txt](https://pivot-payment.gitbook.io/pivot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pivot-payment.gitbook.io/pivot-docs/api-references/api-lists/virtual-terminal/create-virtual-terminal-transaction.md).

# Create Virtual Terminal Transaction

Charge your Encrypted VCC and receive funds settlement

## Method and URL

<mark style="color:green;">`POST`</mark> \[<mark style="color:orange;">BASE\_URL</mark>]/v1/virtual-terminal/charges

{% hint style="info" %}
Use our Encryption Card code here [Card Encryption](https://pivot-payment.gitbook.io/pivot-docs/api-references/api-lists/payments/card-encryption.md) to generate <mark style="color:orange;">`encryptedPayload`</mark>
{% endhint %}

## Request

**Request Body**

```json
{
  "clientReferenceId": "REFORZA-VCC-AGODA-001",
  "bookingReferenceId": "BOOK/20261012/9696969823",
  "travelAgent": "AGODA",
  "amount": {
    "value": 100000,
    "currency": "IDR"
  },
  "encryptedCardDetail": {
    "keyVersion": 5,
    "encryptedPayload": "eyJFbmNyeXB0ZWRLZXkiOiJOMkNmRmkyOVBzODlHQUovVHdsTEd5VGc0YldSZThOb29zd1BYZHVZbW5tdzZzL1Rzd0Z0ajBDdnlhM3pCV3pnMEV1UGNJdlRCMlVXRHE3NjMwTVlnVWRtTEdzM1lyZFk2WnY2UCtva2V6MDMxb3FqSjFUaWNaTkYzUGhONHp1VHkwcEoxYUFBZU1XbmNma1ZuRFFGaHZUeUZwVGFVejVUMHJTKys5eGxoS0c4eWQwTURTSXp4SnNWalpqZlpuOTIxWE1MR2V0b1FROWNUb1dGeFBOcFZFK1p3cGpBMktFRVhoTXRxSlhPOGc1QnJsdnMyZTh3Vm9kbzd5LzBudVBUS3hYUnhJajdlSWN4Z1l6dTJxcE1DMDFxNTdGZ3VHMDNTSmtVZXhEdWxwVUJEckkyeXh1SnBLcmFtZzczejJ2UHVNMFA3WlFIUDgxUzZST2o2Vi9SSnc9PSIsIk5vbmNlIjoiaVdZbmg0UDVFYmY0TUhWWSIsIkNpcGhlcnRleHQiOiJSV2tpUkF2Njd0aURRMHF3aU9pc1BpM2dBZzZIWkx0QmdMZ2Z1dzhwK0RvVTdZWW5ENU5KdTRFa1crOVdVNTZhMlc4Q3E1VHptUEE1aVMvOGpaVDYzci9taDFmTXFOUkxOdUZUcHorbG5MTXhDY0xHTnBObW80aEc2UTk0MVE9PSJ9"
  }
}
```

**Detail Parameter Request**

<table><thead><tr><th width="208.9453125">Parameter</th><th width="111.5390625">Data Type</th><th width="132.98828125">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>Virtual Terminal</td><td>Object</td><td>M</td><td><a data-mention href="https://pivot-payment.gitbook.io/pivot-docs/api-references/api-lists/virtual-terminal/virtual-terminal-object.md">Virtual Terminal Object</a></td></tr></tbody></table>

## Response

**Response Body**

```json
{
  "code": "00",
  "message": "OK",
  "data": {
    "id": "b16e2c2a-1248-4a92-a1ca-9c5e093c68fe",
    "clientReferenceId": "REFORZA-VCC-AGODA-001",
    "bookingReferenceId": "BOOK/20261012/9696969823",
    "travelAgent": "AGODA",
    "amount": {
      "currency": "IDR",
      "value": 100000
    },
    "status": "SUCCESS",
    "merchantId": "e485e01b-ff59-4a47-bb7d-9b39064f3388",
    "chargeDetail": {
      "first6": "555000",
      "first8": "55500001",
      "last4": "0001",
      "expMonth": "01",
      "expYear": "39",
      "binInformations": {
        "type": "DEBIT",
        "issuingBank": "BCA",
        "brand": "MASTERCARD",
        "country": "ID"
      },
      "authorizationResult": {
        "networkTransactionId": "123456789",
        "acquirerReferenceNumber": "123456789",
        "retrievalReferenceNumber": "TRXCCab5a495cec4117918743440",
        "stan": "104539",
        "avsResult": "",
        "cvvResult": "",
        "issuerAuthorizationCode": "00",
        "merchantAdviceCode": "",
        "decline": {
          "code": "",
          "attribution": "",
          "message": ""
        }
      },
      "approvalCode": "971552"
    },
    "createdAt": "2026-10-13T06:52:24.407240214Z",
    "updatedAt": "2026-10-13T06:52:25Z"
  }
}
```

**Detail Parameter Response**

<table><thead><tr><th width="208.9453125">Parameter</th><th width="111.5390625">Data Type</th><th width="132.98828125">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>Virtual Terminal </td><td>Object</td><td>M</td><td><a data-mention href="https://pivot-payment.gitbook.io/pivot-docs/api-references/api-lists/virtual-terminal/virtual-terminal-object.md">Virtual Terminal Object</a></td></tr></tbody></table>
