Thanks to visit codestin.com
Credit goes to www.scribd.com

0% found this document useful (0 votes)
14 views10 pages

Card Issaunce API

The document outlines the API specifications for creating, issuing, adding cards to a wallet, canceling transactions, and reversing transactions for a gift card system. It includes details such as URLs, authentication methods, request and response bodies for each operation. The operations involve managing transactions related to gift cards, including transaction types, amounts, and user information.
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
14 views10 pages

Card Issaunce API

The document outlines the API specifications for creating, issuing, adding cards to a wallet, canceling transactions, and reversing transactions for a gift card system. It includes details such as URLs, authentication methods, request and response bodies for each operation. The operations involve managing transactions related to gift cards, including transaction types, amounts, and user information.
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 10

Create and Issue API

Post URL - https://ajf2m0r1na8eau2bn0brcou5h2i0-


custuatdev.qwikcilver.com/ǪwikCilver/XnP/api/v3/gc/transactions

Auth Type - Bearer Token

Content-Type:application/json
TransactionId:53503
DateAtClient:2024-08-30 00:00:00
Merchantoutletnametooverride:Zepto Seller-1

Request Body

{
"TransactionTypeId": "305",
"InputType": "3",
"InvoiceNumber":"Inv-1212",
"NumberOfCards": "1",
"IdempotencyKey":"Testidemp160620211",
"Cards": [{
"CardProgramGroupName": "Zepto eGift Card-Seller1",
"Amount": "1500"
}],
"Purchaser": {
"FirstName": "Fairoz",
"LastName": "Ahmed",
"Mobile":"9916802132"
},
"Notes": "Create and Issue"
}

Response Body

{
"TransactionId": 53503,
"CurrentBatchNumber": 13293431,
"TransactionTypeId": 305,
"TotalAmount": 1500.0000,
"Notes": "Create and Issue",
"ApprovalCode": "108193608",
"ResponseCode": 0,
"ResponseMessage": "Transaction successful.",
"ErrorCode": null,
"ErrorDescription": null,
"InputType": "3",
"TotalCards": 1,
"NumberOfCards": 1,
"Cards": [
{
"CardNumber": "7975761003493638",
"CardPin": "194892",
"CardStatus": "Activated",
"CardStatusId": 140,
"CardType": "Zepto eGift Card-Seller1",
"CardBehaviourTypeId": 0,
"ExpiryDate": "2025-10-16T17:35:03+05:30",
"TransferCardNumber": "7975801009034420",
"TransferCardExpiry": "2025-03-31T00:00:00+05:30",
"CorporateName": null,
"Balance": 1500.0000,
"TransferCardBalance": 98500.0000,
"AdjustmentAmount": 0.0000,
"AdjustmentAmountInNativeCurrency": 0.0000,
"ActivationAmount": 1500.0000,
"PreXactionCardBalance": 0.0000,
"TransactionAmount": 1500.0000,
"ReloadableAmount": 8500.0000,
"TotalPreAuthAmount": 0.0000,
"TotalReloadedAmount": 0.0000,
"TotalRedeemedAmount": 0.0000,
"CardCurrencySymbol": "₹",
"CurrencyCode": "INR",
"CurrencyConversionRate": 1.0000,
"NativeCardBalance": 1500.0000,
"NativeCurrencyCode": "INR",
"CardNativeBalanceWithoutSymbol": "1500.0000",
"CurrencyConvertedXactionAmount": 1500.0000,
"PreXactionCardBalanceInNativeCurrency": "0.0000",
"PreXactionCardBalanceInNativeCurrencyWithSymbol": "₹ 0.0000",
"CardCreationType": "Virtual",
"ActivationDate": "2024-10-16T17:35:03+05:30",
"Holder": {
"Salutation": null,
"FirstName": "Fairoz",
"LastName": "Ahmed"
},
"InvoiceNumber": "Inv-1212",
"CardProgramGroupType": "Retail Gift Cards",
"IssuerName": "Zepto Limited",
"EmployeeId": null,
"TransactionDateTime": "2024-10-16T17:35:03+05:30",
"ThemeId": null,
"Trackdata": ";7975761003493638=000000001175045?",
"ActivationCode": null,
"CardIssuingMode": "STORE",
"ActivationURL": null,
"BarCode": null,
"ApprovalCode": "108193607",
"ResponseCode": 0,
"ResponseMessage": "Transaction successful.","ErrorCode":
null,
"ErrorDescription": null,
"RedeemStartDate": null,
"PreAuthCode": null,
"RecentTransactions": null,
"Transferable": true,
"Reusable": true,
"Beneficiaries": null,
"Notes": "Create and Issue",
"Reason": null,
"CardFormats": [],
"SequenceNumber": null,
"Buckets": null,
"ExtendedParameters": null
}
],
"BusinessReferenceNumber": null,
"MerchantOutletName": "Zepto ǪC test",
"MerchantOutletCode": "",
"DescriptiveOutletName": "Zepto ǪC test",
"IdempotencyKey": "Testidemp160620211",
"GeneralLedger": null,
"CostCentre": null,
"ExecutionMode": 0,
"NetworkTransactionInfo": null
}
Add Card to Wallet
Post URL - https://ajf2m0r1na8eau2bn0brcou5h2i0-
custuatdev.qwikcilver.com/ǪwikCilver/XnP/api/v3/gc/transactions

Auth Type – Bearer Token

Headers

TransactionId:1005061
DateAtClient:2023-01-10T12:00:01

Request Body

{
"TransactionTypeId": 3508,
"InvoiceNumber": "Inv-01356",
"Ǫuantity": 1,
"Cards": [
{
"CardNumber": "7975991000000019",
"PaymentInstruments": [
{
"InstrumentNumber": "7975761003493638",
"InstrumentPin": "194892",
}
]
}
],
"Notes": "Card Addition"
}

Response Body

{
"TransactionId": 1005061,
"CurrentBatchNumber": 13293431,
"TransactionTypeId": 3508,
"TotalAmount": 0.0000,
"Notes": "Card Addition",
"ApprovalCode": "108193769",
"ResponseCode": 0,
"ResponseMessage": "Transaction successful.",
"ErrorCode": null,
"ErrorDescription": null,
"InputType": null,
"TotalCards": 1,
"NumberOfCards": 1,
"Cards": [
{
"CardNumber": "7975991000000019",
"ExternalCardNumber": "9916802132",
"CardPin": null,
"CardStatus": "Active",
"CardStatusId": 100,
"CardType": null,
"CardBehaviourTypeId": 0,
"ExpiryDate": null,
"TransferCardNumber": null,
"TransferCardExpiry": null,
"CorporateName": null,
"Balance": 4607.0000,
"TotalBalance": 0.0,
"TransferCardBalance": 0.0000,
"AdjustmentAmount": 0.0000,
"AdjustmentAmountInNativeCurrency": 0.0,
"ActivationAmount": 0.0000,
"PreXactionCardBalance": 3107.0000,
"TransactionAmount": 0.0000,
"ReloadableAmount": null,
"TotalPreAuthAmount": null,
"TotalReloadedAmount": null,
"TotalRedeemedAmount": null,
"CardCurrencySymbol": "₹",
"CurrencyCode": "INR",
"CurrencyConversionRate": 1.0000,
"NativeCardBalance": 4607.0000,
"NativeTotalBalance": 0.0,
"NativeCurrencyCode": "INR",
"CardNativeBalanceWithoutSymbol": "4607.0000",
"CurrencyConvertedXactionAmount": 1500.0000,
"PreXactionCardBalanceInNativeCurrency": "3107.0000",
"CardCreationType": null,
"ActivationDate": null,
"Holder": {
"Salutation": "MR.",
"FirstName": "ROSHAN",
"LastName": "MANOJ",
"Mobile": "9916802132",
"Email": "[email protected]"
},
"InvoiceNumber": "Inv-01356",
"CardProgramGroupName": "Zepto test wallet",
"CardProgramGroupType": null,
"CreationDate": "2024-09-06T17:22:52+05:30",
"IssuerName": "Zepto Limited","EmployeeId":
null,
"TransactionDateTime": "2024-10-16T17:39:09+05:30",
"ThemeId": null,
"Trackdata": null,
"ActivationCode": null,
"CardIssuingMode": null,
"ActivationURL": null,
"BarCode": null,
"ApprovalCode": "108193768",
"ResponseCode": 0,
"ResponseMessage": "Transaction successful.","ErrorCode":
null,
"ErrorDescription": null,
"RedeemStartDate": null,
"PreAuthCode": null,
"RecentTransactions": null,
"Transferable": null,
"Reusable": null,
"Beneficiaries": null,
"Notes": "{ValType~CreateWallet}",
"Reason": null,
"CardFormats": [],
"SequenceNumber": null,
"TotalNoOfPaymentInstruments": 0,
"NumberOfCards": 0,
"PaymentInstruments": [
{
"InstrumentNumber": "7975761003493638",
"InstrumentPin": null,
"Balance": 1500.0000,
"CurrencyCode": "INR",
"NativeCurrencyCode": "INR",
"NativeInstrumentBalance": 1500.0000,
"CurrencyConversionRate": 1.0000,
"InstrumentProgram": "Zepto eGift Card-Seller1",
"ExpiryDate": "2025-10-16T17:35:03.107+05:30",
"InstrumentStatus": "Activated",
"InstrumentType": 0,
"PreXactionInstrumentBalance": 1500.0000,
"InstrumentNativeBalanceWithoutSymbol": 1500.0000,
"TransactionAmount": 1500.0000,
"InstrumentProgramGroupType": "Retail Gift Cards",
"ActivationAmount": 0.0000,
"ActivationDate": null,
"Transferable": null,
"Reusable": null,
"ResponseCode": 0,
"ResponseMessage": "Transaction successful.",
"ApprovalCode": "108193767",
"ErrorCode": null,
"ErrorDescription": null,
"RedeemStartDate": null,
"ExtendedParameters": null,
"Holder": null,
"FundType": "CUSTOMER"
}
],
"Buckets": null,
"ExtendedParameters": null
}
],
"BusinessReferenceNumber": null,
"InvoiceNumber": "Inv-01356",
"MerchantOutletName": "Zepto ǪC test",
"MerchantOutletCode": "",
"DescriptiveOutletName": "Zepto ǪC test",
"IdempotencyKey": null,
"GeneralLedger": null,
"CostCentre": null,
"ExecutionMode": 1,
"NetworkTransactionInfo": null
}

Cancel Create and Issue


Post Method

URL - https://ajf2m0r1na8eau2bn0brcou5h2i0-
custuatdev.qwikcilver.com/QwikCilver/XnP/api/v3/gc/transactions/cancel

Headers-

Content-Type:application/json
TransactionId:1924
DateAtClient:2024-08-30 00:00:00
Merchantoutletnametooverride:Zepto Seller-1

Request Body

{
"inputType":"1",
"numberOfCards":"1",
"Cards":[
{
"CardNumber":"7975761003493638",
"Amount":"1500",
"OriginalRequest":
{
"OriginalBatchNumber":"13293431",
"OriginalTransactionId":"53503",
"OriginalApprovalCode":"108193607",
"OriginalAmount":"1500",
"OriginalInvoiceNumber":"Inv-1212"
},
"Reason":"Refund/Fraud"
}
],
"TransactionModeID":"0",
"TransactionTypeId":"328"
}

Response Body

{
"TransactionId": 1924,
"CurrentBatchNumber": 13293431,
"TransactionTypeId": 328,
"TotalAmount": 1500.0000,
"Notes": null,
"ApprovalCode": "108268790",
"ResponseCode": 0,
"ResponseMessage": "Transaction successful.",
"ErrorCode": null,
"ErrorDescription": null,
"InputType": "1",
"TotalCards": 1,
"NumberOfCards": 1,
"Cards": [
{
"CardNumber": "7975761003493638",
"CardPin": null,
"CardStatus": "Cancelled",
"CardStatusId": 310,
"CardType": "Zepto eGift Card-Seller1",
"CardBehaviourTypeId": 0,
"ExpiryDate": null,
"TransferCardNumber": "7975801009034420",
"TransferCardExpiry": "2025-03-31T00:00:00+05:30",
"CorporateName": null,
"Balance": 0.0000,
"TransferCardBalance": 100000.0000,
"AdjustmentAmount": 0.0000,
"AdjustmentAmountInNativeCurrency": 0.0000,
"ActivationAmount": 0.0000,
"PreXactionCardBalance": 1500.0000,
"TransactionAmount": 1500.0000,
"ReloadableAmount": 10000.0000,
"TotalPreAuthAmount": 0.0000,
"TotalReloadedAmount": 0.0000,
"TotalRedeemedAmount": 0.0000,
"CardCurrencySymbol": "₹",
"CurrencyCode": "INR",
"CurrencyConversionRate": 1.0000,
"NativeCardBalance": 0.0000,
"NativeCurrencyCode": null,
"CardNativeBalanceWithoutSymbol": "0.0000",
"CurrencyConvertedXactionAmount": 1500.0000,
"PreXactionCardBalanceInNativeCurrency": "1500.0000",
"PreXactionCardBalanceInNativeCurrencyWithSymbol": "₹ 1,500.0000",
"CardCreationType": "Virtual",
"ActivationDate": "2024-10-16T17:35:03+05:30",
"Holder": {
"Salutation": "MR.",
"FirstName": "ROSHAN",
"LastName": "MANOJ"
},
"InvoiceNumber": "Inv-1212",
"CardProgramGroupType": "Retail Gift Cards",
"IssuerName": "Zepto Limited",
"EmployeeId": "",
"TransactionDateTime": "2024-10-18T17:47:37+05:30",
"ThemeId": null,
"Trackdata": null,
"ActivationCode": null,
"CardIssuingMode": "STORE",
"ActivationURL": null,
"BarCode": null,
"ApprovalCode": "108268789",
"ResponseCode": 0,
"ResponseMessage": "Transaction successful.",
"ErrorCode": null,
"ErrorDescription": null,
"RedeemStartDate": null,
"PreAuthCode": null,
"RecentTransactions": null,
"Transferable": true,
"Reusable": true,
"Beneficiaries": null,
"Notes": null,
"Reason": "Refund/Fraud",
"CardFormats": [],
"SequenceNumber": null,
"Buckets": null,
"ExtendedParameters": null
}
],
"BusinessReferenceNumber": null,
"MerchantOutletName": "Zepto QC test",
"MerchantOutletCode": "",
"DescriptiveOutletName": "Zepto QC test",
"IdempotencyKey": null,
"GeneralLedger": null,
"CostCentre": null,
"ExecutionMode": 0,
"NetworkTransactionInfo": null
}
Reverse Create and Issue
Post Method

URL - https://ajf2m0r1na8eau2bn0brcou5h2i0-
custuatdev.qwikcilver.com/QwikCilver/XnP/api/v3/gc/transactions/reverse

Headers and Request body of “Create and issue” API should remain same without any
changes.

You might also like