Create Virtual Account

Create Virtual Account

Header Parameters

• X-TIMESTAMP string required

  ISO 8601 timestamp

• X-SIGNATURE string required

  Signature

• X-PARTNER-ID string required

  Partner ID

• X-EXTERNAL-ID string required

  External ID

• CHANNEL-ID string required

  Channel ID

application/json

Request Body required

• customerNo string
• virtualAccountName string
• trxId string
• totalAmount object

  value string

  currency string
• virtualAccountTrxType string

  Possible values: [c, o, r]

• expiredDate string

  ISO8601 format

• additionalInfo object

  channel string

  Possible values: [BRI, BNI, BCA, CIMB, MANDIRI, PERMATA, BSI, MUAMALAT, INDOMARET, ALFAMART]

Responses

• 200
• 400
• 401
• 404
• 409
• 500

---

Sukses create virtual account

application/json

• Schema
• Example (from schema)

---

Schema

• responseCode string
• responseMessage string
• virtualAccountData object

  partnerServiceId string

  customerNo string

  virtualAccountNo string

  virtualAccountName string

  trxId string

  totalAmount object

  value string

  currency string

  virtualAccountTrxType string

  expiredDate string

  additionalInfo object

  channel string

  contractId string

{
  "responseCode": "2002700",
  "responseMessage": "Success",
  "virtualAccountData": {
    "partnerServiceId": "22691",
    "customerNo": "15000003212",
    "virtualAccountNo": "2269115000003212",
    "virtualAccountName": "Mas Nchus",
    "trxId": "INV-000000023212x221",
    "totalAmount": {
      "value": "25000.00",
      "currency": "IDR"
    },
    "virtualAccountTrxType": "c",
    "expiredDate": "2023-09-04T19:30:14+07:00",
    "additionalInfo": {
      "channel": "CIMB",
      "contractId": "ci0d9b58e3-127f-4979-b909-ceb5cffdbf23"
    }
  }
}

Invalid mandatory field

application/json

• Schema
• Example (from schema)

---

Schema

• oneOf
  • CreateVaInvalidMandatoryField
  • CreateVaInvalidFieldFormat

  ---
• responseCode string
• responseMessage string

responseCode string

responseMessage string

{
  "responseCode": "4002702",
  "responseMessage": "Invalid mandatory field { field name }"
}

Invalid signature

application/json

• Schema
• Example (from schema)

---

Schema

• responseCode string
• responseMessage InvalidSignatureMessage

{
  "responseCode": "4012700",
  "responseMessage": "Invalid signature {cannot verify signature}"
}

Invalid X-PARTNER-ID

application/json

• Schema
• Example (from schema)

---

Schema

• responseCode string
• responseMessage InvalidPartnerIdMessage

{
  "responseCode": "4042716",
  "responseMessage": "Partner not found"
}

Duplicate X-EXTERNAL-ID in same day

application/json

• Schema
• Example (from schema)

---

Schema

• oneOf
  • CreateVADuplicateXExternalId
  • CreateVADuplicateTrxId

  ---
• responseCode string
• responseMessage string

responseCode string

responseMessage string

{
  "responseCode": "4092700",
  "responseMessage": "Cannot use same X-EXTERNAL-ID in same day"
}