Voucher V.2

Service product Voucher version 2 is second version product with new version. The final process is that existing shops can carry out a claim process for vouchers that have been used to the issuer.


Here's the detail of service action in Voucher V.2 :


Claim Encrypted Voucher

Used by the recipient of the gift voucher to claim the voucher.

Payload Data

NameData Type
VoucherNoString

Example Request

{
   "Subject":"ewallet",
   "SubjectType":"voucher",
   "SubjectIdentifier":"redeemvoucher-v2",
   "Action":"claim-encrypted-voucher",
   "ResourceType":"data",
   "Resource":"none",
   "ResourceId":"none",
   "Data":{
      "VoucherNo": "qvVfBLX8WGM6U7nleTS_7dsvH2OiLvRZ80onekQbgIY"
   }
}
{
    "TicketId": "34352d31-ace3d572-ca68-45b4-a980-f35a34a96e91",
    "Subject": "ewallet",
    "SubjectType": "voucher",
    "SubjectIdentifier": "redeemvoucher-v2",
    "Action": "claim-encrypted-voucher",
    "ResourceType": "data",
    "Resource": "none",
    "ResourceId": "none",
    "Result": null,
    "Status": "success",
    "Message": "Success process data(Success)",
    "StatusCode": 200
}

Get Encrypted Voucher

Used to get voucher data with parameters that have been encrypted because the webview hit process without JWT tokens and used to preview gift vouchers to users.

Payload Data

NameData Type
VoucherNoString

Example Request

{
   "Subject":"ewallet",
   "SubjectType":"voucher",
   "SubjectIdentifier":"redeemvoucher-v2",
   "Action":"get-encrypted-voucher",
   "ResourceType":"data",
   "Resource":"none",
   "ResourceId":"none",
   "Data":{
      "VoucherNo": "qvVfBLX8WGM6U7nleTS_7dsvH2OiLvRZ80onekQbgIY" // aslinya GEN-kwLgpLjdYeMxJqE
   }
}
{
    "TicketId": "34352d31-fe778d28-f88f-43ee-93b3-9b7cbebdf973",
    "Subject": "ewallet",
    "SubjectType": "voucher",
    "SubjectIdentifier": "redeemvoucher-v2",
    "Action": "get-encrypted-voucher",
    "ResourceType": "data",
    "Resource": "none",
    "ResourceId": "none",
    "Result": {
        "ChainSign": null,
        "CustomerId": "0",
        "CustomerName": "Voucher cust name",
        "Date": "02/02/2024 13:49:55",
        "ExpiredDate": "2024-03-27T07:47:16",
        "GreetingCard": {
            "DestinationId": "6281212235198",
            "ExpiredDate": "2034-01-29T21:21:13.613647853Z",
            "FromId": "6281212235198",
            "GreetingCode": "07001",
            "GreetingText": "1",
            "GreetingTitle": null,
            "SenderName": "Wildan Nugraha ",
            "VoucherNominal": "500000"
        },
        "Id": 67,
        "MerchantCode": "MC123",
        "QrCode": "qr-2131231",
        "Signature": "GEN-YleMxLcuTfzpsyx",
        "Status": 1,
        "VoucherNo": "GEN-qeJaRJMjHRRSiwt"
    },
    "Status": "success",
    "Message": "Success process data(Success)",
    "StatusCode": 200
}

Get User Voucher

Used to get users voucher.

Payload Data

NameData Type
CurrentString
sizeString

Example Request

{
   "Subject":"ewallet",
   "SubjectType":"voucher",
   "SubjectIdentifier":"redeemvoucher-v2",
   "Action":"get-user-voucher",
   "ResourceType":"data",
   "Resource":"none",
   "ResourceId":"none",
   "Data":{
      "Current": 1,
      "Size" : 10
   }
}
{
    "TicketId": "34352d31-72929f3a-ebcb-42b3-a8ed-d49e51da1b35",
    "Subject": "ewallet",
    "SubjectType": "voucher",
    "SubjectIdentifier": "redeemvoucher-v2",
    "Action": "get-user-voucher",
    "ResourceType": "data",
    "Resource": "none",
    "ResourceId": "none",
    "Result": {
        "Data": [
            {
                "ChainSign": null,
                "CustomerId": null,
                "CustomerName": "Voucher cust name",
                "Date": "03/27/2021 07:47:16",
                "ExpiredDate": "2024-03-27T07:47:16",
                "GreetingCard": "{\"GreetingCode\":\"07001\",\"GreetingTitle\":null,\"GreetingText\":\"1\",\"DestinationId\":\"6281212235198\",\"FromId\":\"6281212235198\",\"SenderName\":\"Wildan Nugraha \",\"VoucherNominal\":\"500000\",\"ExpiredDate\":\"2034-01-29T21:21:13.613647853Z\"}",
                "Id": 67,
                "MerchantCode": "MC123",
                "QrCode": "qr-2131231",
                "Signature": "Sggp0A92YxWuxw3XrCOw8QDO7KT8kroeTik47ZbDSrMoR7feKxD4pAav5SRfCr7URekSk4lwTUo7vSU+I6RIGdgLzOacD/eLlq7gmJsAqcaa6PTKbwvk2Md+qf6JSBycLFf7V6Px1Ibw2YKPuFCW8nxHRCLipyEtTtwQClpGdo4=",
                "Status": 0,
                "VoucherNo": "GEN-TaxbyLfUrhcrlru"
            },
            {
                "ChainSign": null,
                "CustomerId": null,
                "CustomerName": "Voucher cust name",
                "Date": "03/27/2021 07:47:16",
                "ExpiredDate": "2024-03-27T07:47:16",
                "GreetingCard": "{\"GreetingCode\":\"07001\",\"GreetingTitle\":null,\"GreetingText\":\"1\",\"DestinationId\":\"6281212235198\",\"FromId\":\"6281212235198\",\"SenderName\":\"Wildan Nugraha \",\"VoucherNominal\":\"500000\",\"ExpiredDate\":\"2034-01-29T21:21:13.613647853Z\"}",
                "Id": 66,
                "MerchantCode": "MC123",
                "QrCode": "qr-2131231",
                "Signature": "Sggp0A92YxWuxw3XrCOw8QDO7KT8kroeTik47ZbDSrMoR7feKxD4pAav5SRfCr7URekSk4lwTUo7vSU+I6RIGdgLzOacD/eLlq7gmJsAqcaa6PTKbwvk2Md+qf6JSBycLFf7V6Px1Ibw2YKPuFCW8nxHRCLipyEtTtwQClpGdo4=",
                "Status": 1,
                "VoucherNo": "45678-exactno1"
            },
            {
                "ChainSign": null,
                "CustomerId": null,
                "CustomerName": "Voucher cust name",
                "Date": "03/27/2021 07:47:16",
                "ExpiredDate": "2024-03-27T07:47:16",
                "GreetingCard": "{\"GreetingCode\":\"07001\",\"GreetingTitle\":null,\"GreetingText\":\"1\",\"DestinationId\":\"6281212235198\",\"FromId\":\"6281212235198\",\"SenderName\":\"Wildan Nugraha \",\"VoucherNominal\":\"500000\",\"ExpiredDate\":\"2034-01-29T21:21:13.613647853Z\"}",
                "Id": 65,
                "MerchantCode": "MC123",
                "QrCode": "qr-2131231",
                "Signature": "Sggp0A92YxWuxw3XrCOw8QDO7KT8kroeTik47ZbDSrMoR7feKxD4pAav5SRfCr7URekSk4lwTUo7vSU+I6RIGdgLzOacD/eLlq7gmJsAqcaa6PTKbwvk2Md+qf6JSBycLFf7V6Px1Ibw2YKPuFCW8nxHRCLipyEtTtwQClpGdo4=",
                "Status": 1,
                "VoucherNo": "45678-exactno1"
            },
            {
                "ChainSign": null,
                "CustomerId": null,
                "CustomerName": "Voucher cust name",
                "Date": "03/27/2021 07:47:16",
                "ExpiredDate": "2024-03-27T07:47:16",
                "GreetingCard": "{\"GreetingCode\":\"07001\",\"GreetingTitle\":null,\"GreetingText\":\"1\",\"DestinationId\":\"6281212235198\",\"FromId\":\"6281212235198\",\"SenderName\":\"Wildan Nugraha \",\"VoucherNominal\":\"500000\",\"ExpiredDate\":\"2034-01-29T21:21:13.613647853Z\"}",
                "Id": 62,
                "MerchantCode": "MC123",
                "QrCode": "qr-2131231",
                "Signature": "Sggp0A92YxWuxw3XrCOw8QDO7KT8kroeTik47ZbDSrMoR7feKxD4pAav5SRfCr7URekSk4lwTUo7vSU+I6RIGdgLzOacD/eLlq7gmJsAqcaa6PTKbwvk2Md+qf6JSBycLFf7V6Px1Ibw2YKPuFCW8nxHRCLipyEtTtwQClpGdo4=",
                "Status": 1,
                "VoucherNo": "45678-exactno1"
            }
        ],
        "Page": {
            "Current": 1,
            "Pages": 1,
            "Rows": 4,
            "Size": 10
        }
    },
    "Status": "success",
    "Message": "Success process data(Success)",
    "StatusCode": 200
}

Share Voucher

Used to share voucher to other users.

Payload Data

NameData Type
PhoneNumberString
VoucherNoString

Example Request

{
    "Subject":"ewallet",
    "SubjectType":"voucher",
    "SubjectIdentifier":"redeemvoucher-v2",
    "Action":"share-voucher",
    "ResourceType":"data",
    "Resource":"none",
    "ResourceId":"none",
    "Data":{
       "PhoneNumber": "6281212235198",
       "VoucherNo" : "CPN-C6BLY-zbQXOqcZxMVtmRc"
    }
}
{
    "TicketId": "34352d31-69bb2a81-cb51-4595-b621-bfdd34b0841a",
    "Subject": "ewallet",
    "SubjectType": "voucher",
    "SubjectIdentifier": "redeemvoucher-v2",
    "Action": "share-voucher",
    "ResourceType": "data",
    "Resource": "none",
    "ResourceId": "none",
    "Result": null,
    "Status": "success",
    "Message": "Success process data(Success)",
    "StatusCode": 200
}