Capture Transactions
Description¶
The captureTransactions
endpoint captures funds for a given authorization (auth) transaction.
Request¶
Endpoint¶
/ui/v1/captureTransactions
Method¶
POST
Header¶
Content-Type: application/json Authorization: Basic $TOKEN
Note
Replace $TOKEN
in the request with the base64-encoded username/password combination in the format username:password
.
Given a username of username
and a password of password
, the request header would appear as follows:
Content-Type: application/json
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
Attributes¶
A • is a child element, • • is a grandchild element, • • • is a great-grandchild element.
ELEMENT | DESCRIPTION | FORMAT |
---|---|---|
transactionsIds | Required Id of the parent transaction |
1234 |
• captureMoney | Required | |
•• amount | Required capture amount |
100.00 |
• memo | Optional Any notes for the respective capture |
|
•merchantId | Optional Merchant Id to which the transaction belongs |
Body¶
{
"transactionIds": [
"168"
],
"captureMoney": {
"amount": "500.00"
},
"memo": "",
"merchantId": 3
}
Note
Response¶
{
"tiList": [
{
"id": 169,
"originalOrderId": "1000000166",
"pymtGtwyRefNumber": "181233",
"authCode": "388389",
"parentPymtGtwyRefNumber": "4f45fdcd-f4b5-4c30-83af-0b7cf7cd510a",
"paymentGateway": {
"value": "Cielo (E-commerce)",
"name": "CIELO_ECOMMERCE"
},
"money": {
"amount": 500.000,
"currency": {
"id": 25,
"currencyCode": "BRL",
"currencyText": "Brazilian Real",
"currencySymbol": "R$",
"fractionalUnit": "Centavo",
"numOfDecimalPlaces": "2",
"supportedByVisaCheckout": true,
"createdDateTime": 1650902464000,
"isoNumericCode": "986",
"isoCountryCode": "076"
}
},
"orderId": "1000000167",
"splitPaymentsTxnSequence": "2",
"encryptedPaymentMethod": null,
"paymentMethodType": {
"value": "Mastercard",
"name": "MASTERCARD"
},
"encodedMetaData": null,
"responseMsg": "Operation Successful",
"responseCode": "6",
"createdDateTime": 1677516623000,
"lastUpdatedDateTime": null,
"initiatedDateTime": 1677516075000,
"transactionStatus": {
"value": "Success",
"name": "SUCCESS"
},
"channel": {
"id": 4,
"channelName": "Clubmed-Trancoso",
"channelStatus": {
"value": "Active",
"name": "ACTIVE"
},
"channelType": {
"value": "External",
"name": "EXTERNAL"
},
"createdDateTime": 1672331082000,
"merchantId": 3,
"lockedDateTime": null,
"lockedByUserId": null,
"createdUserId": 1,
"lastModifiedUserId": 27,
"industryType": {
"value": "eCommerce",
"name": "ECOMMERCE"
},
"allowCashAsPaymentMethodInd": false,
"allowMoneyOrderAsPaymentMethodInd": false,
"allowPaperCheckAsPaymentMethodInd": false,
"allowEStoreCreditAsPaymentMethodInd": false,
"paymentMethods": [
{
"id": 166,
"paymentMethodType": {
"value": "Boleto Bancário",
"name": "BOLETO_BANCARIO"
},
"paymentGateway": {
"value": "Cielo (E-commerce)",
"name": "CIELO_ECOMMERCE"
},
"cardBrand": {
"value": "Boleto Bancário",
"name": "BOLETO_BANCARIO"
},
"cardId": null,
"createdUserId": 1,
"lastModifiedUserId": 27,
"createdDateTime": 1674568009000,
"lastUpdatedDateTime": null,
"position": 37
},
{
"id": 119,
"paymentMethodType": {
"value": "Voucher Card",
"name": "VOUCHER_CARD"
},
"paymentGateway": {
"value": "Cielo (E-commerce)",
"name": "CIELO_ECOMMERCE"
},
"cardBrand": {
"value": "Alelo",
"name": "ALELO"
},
"cardId": 1360,
"createdUserId": 1,
"lastModifiedUserId": 27,
"createdDateTime": 1672331083000,
"lastUpdatedDateTime": null,
"position": 24
},
{
"id": 113,
"paymentMethodType": {
"value": "Debit Card",
"name": "PIN_LESS_DEBIT_CARD"
},
"paymentGateway": {
"value": "Cielo (E-commerce)",
"name": "CIELO_ECOMMERCE"
},
"cardBrand": {
"value": "VISA Debit",
"name": "VISA_DEBIT"
},
"cardId": 1340,
"createdUserId": 1,
"lastModifiedUserId": 27,
"createdDateTime": 1672331083000,
"lastUpdatedDateTime": null,
"position": 18
},
{
"id": 105,
"paymentMethodType": {
"value": "3D Secure",
"name": "THREE_D_SECURE"
},
"paymentGateway": {
"value": "Cielo (E-commerce)",
"name": "CIELO_ECOMMERCE"
},
"cardBrand": {
"value": "VERIFIED by VISA",
"name": "VERIFIED_BY_VISA"
},
"cardId": 1320,
"createdUserId": 1,
"lastModifiedUserId": 27,
"createdDateTime": 1672331083000,
"lastUpdatedDateTime": null,
"position": 10
},
{
"id": 95,
"paymentMethodType": {
"value": "Credit Card",
"name": "CREDIT_CARD"
},
"paymentGateway": {
"value": "Cielo (E-commerce)",
"name": "CIELO_ECOMMERCE"
},
"cardBrand": {
"value": "VISA",
"name": "VISA"
},
"cardId": 1301,
"createdUserId": 1,
"lastModifiedUserId": 27,
"createdDateTime": 1672331083000,
"lastUpdatedDateTime": null,
"position": 0
}
],
"allowDynamicRoutingCapabilityInd": false,
"secondaryPaymentGateway": null,
"tertiaryPaymentGateway": null,
"userCount": null,
"assignedPaymentMethods": null,
"message": null,
"paymentMethodsCount": null,
"merchantName": null
},
"transactionType": {
"value": "Capture",
"name": "CAPTURE"
},
"batchStatus": {
"value": "Processed",
"name": "PROCESSED"
},
"lockedDateTime": null,
"lockedByUserId": null,
"createdUserId": 27,
"lastModifiedUserId": null,
"reconcileTransactionRefNumber": "",
"paymentService2000Data": null,
"batchID": null,
"voidActionInd": false,
"refundActionInd": false,
"captureActionInd": false,
"incrementalAuthActionInd": false,
"reAuthActionInd": false,
"paymentType": {
"name": "SINGLE_PAYMENT"
},
"paymentCycle": null,
"totalCapturedAmount": null,
"totalRefundedAmount": null,
"refundStatus": {
"value": "None",
"name": "NONE"
},
"refundMethod": null,
"totalVoidedAmount": null,
"voidStatus": {
"value": "None",
"name": "NONE"
},
"incrementalAuthAmount": null,
"reAuthAmount": null,
"totalAuthAmount": null,
"scheduledPaymentDateTime": null,
"subscriptionId": null,
"transactionOwnerId": 27,
"vcOrderId": null,
"invoiceNumber": "",
"customerNumber": "",
"transactionCategory": {
"value": "Card Not Present (CNP)",
"name": "CARD_NOT_PRESENT"
},
"encryptedGeolocationInfo": "1EmZBRkIFKlEAwLMz6H1LmrLZLNtTUtrHgdPAbp3+IM47M89YQnCbKItMOwDvtukV9lmFiFwhelKBPDoOpkXVQLcqmzu8j6iV6mwHV/QV2VblEdmluqh7geaZd0hWrA6dj+9I5+DIgA2rRJ9F1H9EJOk0eIr/YWQVZZ/iDuOz/HNgbLU6Y3CRIqI8LJ751XuzwjSASFoHzHdAmOvMOZ/O0cSZD2WrZtA2pndzU9QeL/qZWVgosmFzXv++1jmJlprVV2qT6Mmsb0vbBRPU86m/yXxt680SiLvlzDO4kjcpuOJxjb9QtkRFWhqSvJ8ZCD8SiEfeBmWrGosG9wRns2z/Y+INY290FHIKJh0+Nv36brR1n6lKlR7iy6k1LbpblZMPKhwUwcEzi1GXuEEmWaeYyqy+1LVk7R1bpTEG7KQ+7LvIyFNdIfCE88Y1cUbs4e0chr/qnc9PilljarswPnWwrVpXyVEgRF+NMSVd0yWS3ByeMM/wiS/sNroEGLuirehX4WVabW7PjL4oaHByqoxoMH0R/i8tqbzU48Dp2TtygyrJhLuFXi6BeI7RbDvqxLkDLRexgZIh+kSctmdZiN8sps64F2tUJfXO+FoUlNdx6PsVsBkOLottuAHmbxIj2+xAe1nShirzSnAoAJuL30sVLzY8deGW0HZztTY3yRIP6GY95NKkhZwbVF0gx1ohS4y8+TbvJdP6VQGbs8gW62PFA==",
"voidReason": "",
"refundReason": "",
"captureAmount": 500.000,
"voidAmount": null,
"posEntryMode": {
"value": "Manual Entry - Wired (Current EMV)",
"name": "MANUAL_ENTRY_WIRED"
},
"merchantId": 3,
"memo": "",
"partialAuthAmount": null,
"retryTraceNumber": null,
"lastFourDigitsOfAcctNum": "4444",
"merchantNumber": "16a7aaff-2300-4a58-b4fc-83f83275ee32",
"digitalSignature": null,
"goodsAndServicesPurchaseType": {
"indicator": "",
"value": "Service",
"name": "SERVICE"
},
"checkInDate": null,
"checkOutDate": null,
"bookingNumber": "",
"groupName": "",
"customerName": "John Smith",
"merchantLocation": null,
"customerId": null,
"routingLevel": {
"value": "Primary",
"name": "PRIMARY"
},
"productCode": "Trancoso1",
"convenienceFees": 0.000,
"acquirerTerminalId": "00000001",
"transactionStatusInformation": null,
"applicationIdentifier": null,
"terminalVerificationResults": null,
"issuerApplicationData": null,
"cardholderVerificationMethodResults": null,
"macKSN": null,
"issuerAuthenticationData": null,
"issuerScriptTemplate1": null,
"issuerScriptTemplate2": null,
"applicationLabel": null,
"fiservIPGTransactionId": null,
"transactionDetails": [],
"posTerminalId": null,
"qualifiedHealthcareAmount": null,
"amountType": {
"value": "Unknown",
"code": "",
"name": "UNKNOWN"
},
"avsResultCode": null,
"cvvResultCode": null,
"fiservLocalTransmissionDateTime": null,
"numberOfInstallments": 0,
"merchantCategoryCode": null,
"membershipNumber": "",
"field55EMVData": null,
"captureMode": {
"value": "Host Capture (HCS)",
"name": "HOST_CAPTURE"
},
"eightDigitBIN": "01c02776d7290e999c60af8413927df1d389690aab8cac12503066cf62e899f6",
"binIssuingCountryCode": "BR",
"cardNetworkTransactionId": null,
"recurrenceEndDate": null,
"electronicCommerceIndicator": null,
"posTerminal": null,
"returnURL": null,
"cancelURL": null,
"paymentRedirectURL": null,
"cardType": null,
"realex3DSecureVISAPit": "",
"realex3DSecureURL": "",
"realex3DSecurePaReq": "",
"realex3DSecureEncodedMD": "",
"realexRequestID": "",
"createdUserName": null,
"capturePymtGtwyRefNumber": null,
"transactionOwnerUserName": null,
"geolocation": null,
"addProfileAsPartOfAuthRequest": false,
"paymentAction": null,
"merchantName": null,
"productName": null,
"strCheckInDate": null,
"strCheckOutDate": null,
"serialNumber": null,
"textMessageType": null,
"avsResponseStatus": null,
"cvvResponseStatus": null,
"profileSubscriptionId": null,
"message": null,
"ipaymentMethod": null,
"ssoenabledInd": "",
"transactionDetailMap": {},
"qrcodeBase64Image": null,
"qrcodeCopyURL": null,
"qrcodeBase64ImageString": null,
"IFDSerialNumber": null
}
]
}
Updated As Of Version 5.5.1.1