Capture transaction

POST

/v2/MoneyIn/capture/:transId

POST

/api/v2/MoneyIn/capture/:transId

curl -X POST https://api-sandbox.payabli.com/api/v2/MoneyIn/capture/10-7d9cd67d-2d5d-4cd7-a1b7-72b8b201ec13 \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "paymentDetails": {
    "totalAmount": 105,
    "serviceFee": 5
  }
}'

{
  "code": "A0000",
  "reason": "Approved",
  "explanation": "Approved by card network or card issuer.",
  "action": "No action required.",
  "data": {
    "parentOrgName": "Mrinal's Pet Supplies",
    "paypointDbaname": "Mrinal's Pet Shop North",
    "paypointLegalname": "Mrinal's Pet Shop North",
    "paypointEntryname": "495147f647",
    "paymentTransId": "3040-96dfa9a7c4ed4f82a3dd4a4a12ad28ae",
    "connectorName": "gp",
    "externalProcessorInformation": "",
    "gatewayTransId": "TRN_Ih68D6UZdip7OEQ2QFXat1yQSLF2nB",
    "orderId": null,
    "method": "card",
    "batchNumber": "3040_combined_20251201_3a50747d-6b5c-40ef-9f69-93a9cc7fcb49",
    "batchAmount": 420,
    "payorId": 4440,
    "paymentData": {
      "maskedAccount": "4XXXXXXXXXXX5439",
      "accountType": "visa",
      "accountExp": "12/25",
      "holderName": "John Cassian",
      "storedId": null,
      "initiator": null,
      "storedMethodUsageType": null,
      "sequence": null,
      "orderDescription": "",
      "accountId": null,
      "signatureData": null,
      "binData": {
        "binMatchedLength": "6",
        "binCardBrand": "VISA",
        "binCardType": "CREDIT",
        "binCardCategory": "CLASSIC",
        "binCardIssuer": "",
        "binCardIssuerCountry": "RUSSIAN FEDERATION",
        "binCardIssuerCountryCodeA2": "RU",
        "binCardIssuerCountryNumber": "643",
        "binCardIsRegulated": "",
        "binCardUseCategory": "",
        "binCardIssuerCountryCodeA3": ""
      },
      "paymentDetails": {
        "totalAmount": 105,
        "serviceFee": 5,
        "checkNumber": null,
        "checkUniqueId": "",
        "currency": "USD",
        "orderDescription": null,
        "orderId": null,
        "orderIdAlternative": null,
        "paymentDescription": null,
        "groupNumber": null,
        "source": null,
        "payabliTransId": null,
        "categories": [],
        "splitFunding": [],
        "checkImage": null,
        "unbundled": null
      }
    },
    "transStatus": 1,
    "paypointId": 3040,
    "totalAmount": 105,
    "netAmount": 100,
    "feeAmount": 5,
    "settlementStatus": 0,
    "operation": "Sale",
    "responseData": {
      "resultCode": "A0000",
      "resultCodeText": "Approved",
      "response": null,
      "responsetext": "CAPTURED",
      "authcode": "AXS425",
      "transactionid": "TRN_Xo4dpKfmx3OxSc9svd2ccI6OOnyB2I",
      "avsresponse": "N",
      "avsresponse_text": "No Match, No address or ZIP match",
      "cvvresponse": "M",
      "cvvresponse_text": "CVV2/CVC2 match",
      "orderid": null,
      "response_code": "100",
      "response_code_text": "Operation successful",
      "customer_vault_id": null,
      "emv_auth_response_data": null,
      "type": null
    },
    "source": "api",
    "scheduleReference": 0,
    "orgId": 123,
    "refundId": 0,
    "returnedId": 0,
    "chargebackId": 0,
    "retrievalId": 0,
    "invoiceData": {
      "invoiceNumber": null,
      "invoiceDate": null,
      "invoiceDueDate": null,
      "invoiceEndDate": null,
      "invoiceStatus": null,
      "invoiceType": null,
      "frequency": null,
      "paymentTerms": null,
      "termsConditions": null,
      "notes": null,
      "tax": null,
      "discount": null,
      "invoiceAmount": null,
      "freightAmount": null,
      "dutyAmount": null,
      "purchaseOrder": null,
      "firstName": null,
      "lastName": null,
      "company": null,
      "shippingAddress1": null,
      "shippingAddress2": null,
      "shippingCity": null,
      "shippingState": null,
      "shippingZip": null,
      "shippingCountry": null,
      "shippingEmail": null,
      "shippingPhone": null,
      "shippingFromZip": null,
      "summaryCommodityCode": null,
      "items": null,
      "attachments": null,
      "additionalData": null
    },
    "entrypageId": 0,
    "externalPaypointID": "",
    "isValidatedACH": false,
    "transactionTime": "2025-12-01T09:50:03.559",
    "customer": {
      "identifiers": null,
      "firstName": "John",
      "lastName": "Cassian",
      "companyName": null,
      "billingAddress1": "728 Larkspur Lane",
      "billingAddress2": "",
      "billingCity": "Asheville",
      "billingState": "NC",
      "billingZip": "28801",
      "billingCountry": "US",
      "billingPhone": "+18285550147",
      "billingEmail": "john.cassian@example.com",
      "customerNumber": "C-90010",
      "shippingAddress1": "728 Larkspur Lane",
      "shippingAddress2": "",
      "shippingCity": "Asheville",
      "shippingState": "NC",
      "shippingZip": "28801",
      "shippingCountry": "US",
      "customerId": 4440,
      "customerStatus": 0,
      "additionalData": null
    },
    "splitFundingInstructions": null,
    "cfeeTransactions": [
      {
        "cFeeTransid": "3040-96dfa9a7c4ed4f82a3dd4a4a12ad28ae",
        "feeAmount": 5,
        "operation": "Sale",
        "refundId": 0,
        "responseData": {},
        "settlementStatus": 0,
        "transactionTime": "2025-12-01T09:50:03.559",
        "transStatus": 1
      }
    ],
    "transactionEvents": [
      {
        "transEvent": "Created",
        "eventData": "0HNHD68HATSUC:00000001",
        "eventTime": "2025-12-01T09:50:02.558651"
      },
      {
        "transEvent": "Approved",
        "eventData": "0HNHD68HATSUC:00000001",
        "eventTime": "2025-12-01T09:50:03.609111"
      }
    ],
    "riskStatus": "PASSED",
    "riskReason": "",
    "riskAction": "",
    "deviceId": "",
    "achSecCode": "",
    "achHolderType": "personal",
    "ipAddress": "255.255.255.255",
    "isSameDayACH": false,
    "walletType": null,
    "pendingFeeAmount": 0,
    "riskFlagged": false,
    "riskFlaggedOn": "2025-12-01T09:50:02.5474568",
    "riskActionCode": 0,
    "transAdditionalData": null
  },
  "token": null
}

Capture an authorized transaction to complete the transaction and move funds from the customer to merchant account. This is the v2 version of the api/MoneyIn/capture/{transId} endpoint, and returns the unified response format. See Pay In unified response codes reference for more information.

Capture an authorized transaction to complete the transaction and move funds from the customer to merchant account. This is the v2 version of the `api/MoneyIn/capture/{transId}` endpoint, and returns the unified response format. See [Pay In unified response codes reference](/guides/pay-in-unified-response-codes-reference) for more information.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

requestTokenstring

Long-lived API token sent in the requestToken header. See API token authentication.

Path parameters

transIdstringRequired

ReferenceId for the transaction (PaymentId).

Request

This endpoint expects an object.

paymentDetailsobjectRequired

Response

codestring

Payabli’s unified response code. Starts with A (Approved) or D (Declined) followed by a four-digit code that provides specific details about the transaction result. See Pay In unified response codes reference for more information.

reasonstring

Human-readable reason corresponding to the response code.

explanationstring

Detailed description of the response code.

actionstring

Recommended resolution approach or next steps based on the response.

dataobject

Complete transaction details returned by v2 Money In endpoints. This matches the structure of the transaction details previously returned by the v1 details endpoint.

tokenstring or null

Pagination token (equivalent to pageIdentifier in v1 APIs). Returns null when pagination is not applicable.

Errors

400

Bad Request Error

401

Unauthorized Error

402

Payment Required Error

500

Internal Server Error