--- updatedAt: 2025-06-12T00:06:12.000Z agentTools: projectIndex: https://developers.tap.company/llms.txt --- # Retrieve a Charge This endpoint retrieves the details of a charge that was previously created. Just supply the unique `charge.id` that was returned from your previous request, and Tap will return the corresponding charge information. The same information is returned to the `post.url` as raw JSON data. **Please review the Charge Response Model to get more info.** # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "charges.", "version": "1.0" }, "servers": [ { "url": "https://api.tap.company/v2/charges" } ], "components": { "securitySchemes": { "sec0": { "type": "apiKey", "in": "header", "name": "Authorization", "x-bearer-format": "bearer", "x-default": "sk_test_XKokBfNWv6FIYuTMg5sLPjhJ" } } }, "security": [ { "sec0": [] } ], "paths": { "/{charge_id}": { "get": { "summary": "Retrieve a Charge", "description": "This endpoint retrieves the details of a charge that was previously created.", "operationId": "retrieve-a-charges", "parameters": [ { "name": "charge_id", "in": "path", "description": "The unique ``charge.id`` that was returned from your previous charge request.", "schema": { "type": "string" }, "required": true } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{\n\t\"id\": \"chg_TS050120220958Bk240709704\",\n\t\"object\": \"charge\",\n\t\"live_mode\": false,\n\t\"api_version\": \"V2\",\n\t\"method\": \"GET\",\n\t\"status\": \"CAPTURED\",\n\t\"amount\": 1.000,\n\t\"currency\": \"KWD\",\n\t\"threeDSecure\": false,\n\t\"card_threeDSecure\": false,\n\t\"save_card\": false,\n\t\"merchant_id\": \"\",\n\t\"product\": \"GOSELL\",\n\t\"description\": \"Test Description\",\n\t\"metadata\": {\n\t\t\"udf1\": \"Metadata 1\"\n\t},\n\t\"transaction\": {\n\t\t\"authorization_id\": \"321387\",\n\t\t\"timezone\": \"UTC+03:00\",\n\t\t\"created\": \"1662544753039\",\n\t\t\"expiry\": {\n\t\t\t\"period\": 30,\n\t\t\t\"type\": \"MINUTE\"\n\t\t},\n\t\t\"asynchronous\": false,\n\t\t\"amount\": 1.030,\n\t\t\"currency\": \"KWD\"\n\t},\n\t\"reference\": {\n\t\t\"track\": \"tck_TS050120220958Xx440709704\",\n\t\t\"payment\": \"1707220958097045920\",\n\t\t\"gateway\": \"123456789\",\n\t\t\"acquirer\": \"225006321387\",\n\t\t\"transaction\": \"txn_01\",\n\t\t\"order\": \"ord_01\"\n\t},\n\t\"response\": {\n\t\t\"code\": \"000\",\n\t\t\"message\": \"Captured\"\n\t},\n\t\"acquirer\": {\n\t\t\"response\": {\n\t\t\t\"code\": \"00\",\n\t\t\t\"message\": \"Approved\"\n\t\t}\n\t},\n\t\"gateway\": {\n\t\t\"response\": {\n\t\t\t\"code\": \"0\",\n\t\t\t\"message\": \"Transaction Approved\"\n\t\t}\n\t},\n\t\"card\": {\n\t\t\"object\": \"card\",\n\t\t\"first_six\": \"511111\",\n\t\t\"scheme\": \"MASTERCARD\",\n\t\t\"brand\": \"MASTERCARD\",\n\t\t\"type\": \"DEBIT\",\n\t\t\"category\": \"STANDARD\",\n\t\t\"last_four\": \"1118\"\n\t},\n\t\"receipt\": {\n\t\t\"id\": \"202007220958092921\",\n\t\t\"email\": true,\n\t\t\"sms\": true\n\t},\n\t\"customer\": {\n\t\t\"id\": \"cus_TS051320220959Di9e0709722\",\n\t\t\"first_name\": \"test\",\n\t\t\"last_name\": \"test\",\n\t\t\"email\": \"test@test.com\",\n\t\t\"phone\": {\n\t\t\t\"country_code\": \"965\",\n\t\t\t\"number\": \"51234567\"\n\t\t}\n\t},\n\t\"merchant\": {\n\t\t\"country\": \"KW\",\n\t\t\"currency\": \"KWD\",\n\t\t\"id\": \"599424\"\n\t},\n\t\"source\": {\n\t\t\"object\": \"token\",\n\t\t\"type\": \"CARD_NOT_PRESENT\",\n\t\t\"payment_type\": \"DEBIT\",\n\t\t\"payment_method\": \"MASTERCARD\",\n\t\t\"channel\": \"INTERNET\",\n\t\t\"id\": \"tok_Xx1e922659l00Z7gI8b577\"\n\t},\n\t\"redirect\": {\n\t\t\"status\": \"SUCCESS\",\n\t\t\"url\": \"http://your_website.com/redirect_url\"\n\t},\n\t\"post\": {\n\t\t\"status\": \"SUCCESS\",\n\t\t\"url\": \"http://your_website.com/post_url\"\n\t},\n\t\"issuer\": {\n\t\t\"id\": \"bnk_TS052820221011q2O50709262\",\n\t\t\"name\": \"U.S. BANK, N.A.\",\n\t\t\"country\": \"US\",\n\t\t\"region\": \"global\"\n\t},\n\t\"activities\": [\n\t\t{\n\t\t\t\"id\": \"activity_TS061320220959h2J50709738\",\n\t\t\t\"object\": \"activity\",\n\t\t\t\"created\": 1662544753039,\n\t\t\t\"status\": \"INITIATED\",\n\t\t\t\"currency\": \"KWD\",\n\t\t\t\"amount\": 1.000,\n\t\t\t\"remarks\": \"charge - created\"\n\t\t},\n\t\t{\n\t\t\t\"id\": \"activity_TS071520220959Rg120709744\",\n\t\t\t\"object\": \"activity\",\n\t\t\t\"created\": 1662544755744,\n\t\t\t\"status\": \"CAPTURED\",\n\t\t\t\"currency\": \"KWD\",\n\t\t\t\"amount\": 1.030,\n\t\t\t\"remarks\": \"charge - captured\"\n\t\t}\n\t],\n\t\"auto_reversed\": false\n}" } }, "schema": { "type": "object", "properties": { "id": { "type": "string", "example": "chg_TS050120220958Bk240709704" }, "object": { "type": "string", "example": "charge" }, "live_mode": { "type": "boolean", "example": false, "default": true }, "api_version": { "type": "string", "example": "V2" }, "method": { "type": "string", "example": "GET" }, "status": { "type": "string", "example": "CAPTURED" }, "amount": { "type": "integer", "example": 1, "default": 0 }, "currency": { "type": "string", "example": "KWD" }, "threeDSecure": { "type": "boolean", "example": false, "default": true }, "card_threeDSecure": { "type": "boolean", "example": false, "default": true }, "save_card": { "type": "boolean", "example": false, "default": true }, "merchant_id": { "type": "string", "example": "" }, "product": { "type": "string", "example": "GOSELL" }, "description": { "type": "string", "example": "Test Description" }, "metadata": { "type": "object", "properties": { "udf1": { "type": "string", "example": "Metadata 1" } } }, "transaction": { "type": "object", "properties": { "authorization_id": { "type": "string", "example": "321387" }, "timezone": { "type": "string", "example": "UTC+03:00" }, "created": { "type": "string", "example": "1662544753039" }, "expiry": { "type": "object", "properties": { "period": { "type": "integer", "example": 30, "default": 0 }, "type": { "type": "string", "example": "MINUTE" } } }, "asynchronous": { "type": "boolean", "example": false, "default": true }, "amount": { "type": "number", "example": 1.03, "default": 0 }, "currency": { "type": "string", "example": "KWD" } } }, "reference": { "type": "object", "properties": { "track": { "type": "string", "example": "tck_TS050120220958Xx440709704" }, "payment": { "type": "string", "example": "1707220958097045920" }, "gateway": { "type": "string", "example": "123456789" }, "acquirer": { "type": "string", "example": "225006321387" }, "transaction": { "type": "string", "example": "txn_01" }, "order": { "type": "string", "example": "ord_01" } } }, "response": { "type": "object", "properties": { "code": { "type": "string", "example": "000" }, "message": { "type": "string", "example": "Captured" } } }, "acquirer": { "type": "object", "properties": { "response": { "type": "object", "properties": { "code": { "type": "string", "example": "00" }, "message": { "type": "string", "example": "Approved" } } } } }, "gateway": { "type": "object", "properties": { "response": { "type": "object", "properties": { "code": { "type": "string", "example": "0" }, "message": { "type": "string", "example": "Transaction Approved" } } } } }, "card": { "type": "object", "properties": { "object": { "type": "string", "example": "card" }, "first_six": { "type": "string", "example": "511111" }, "scheme": { "type": "string", "example": "MASTERCARD" }, "brand": { "type": "string", "example": "MASTERCARD" }, "type": { "type": "string", "example": "DEBIT" }, "category": { "type": "string", "example": "STANDARD" }, "last_four": { "type": "string", "example": "1118" } } }, "receipt": { "type": "object", "properties": { "id": { "type": "string", "example": "202007220958092921" }, "email": { "type": "boolean", "example": true, "default": true }, "sms": { "type": "boolean", "example": true, "default": true } } }, "customer": { "type": "object", "properties": { "id": { "type": "string", "example": "cus_TS051320220959Di9e0709722" }, "first_name": { "type": "string", "example": "test" }, "last_name": { "type": "string", "example": "test" }, "email": { "type": "string", "example": "test@test.com" }, "phone": { "type": "object", "properties": { "country_code": { "type": "string", "example": "965" }, "number": { "type": "string", "example": "51234567" } } } } }, "merchant": { "type": "object", "properties": { "country": { "type": "string", "example": "KW" }, "currency": { "type": "string", "example": "KWD" }, "id": { "type": "string", "example": "599424" } } }, "source": { "type": "object", "properties": { "object": { "type": "string", "example": "token" }, "type": { "type": "string", "example": "CARD_NOT_PRESENT" }, "payment_type": { "type": "string", "example": "DEBIT" }, "payment_method": { "type": "string", "example": "MASTERCARD" }, "channel": { "type": "string", "example": "INTERNET" }, "id": { "type": "string", "example": "tok_Xx1e922659l00Z7gI8b577" } } }, "redirect": { "type": "object", "properties": { "status": { "type": "string", "example": "SUCCESS" }, "url": { "type": "string", "example": "http://your_website.com/redirect_url" } } }, "post": { "type": "object", "properties": { "status": { "type": "string", "example": "SUCCESS" }, "url": { "type": "string", "example": "http://your_website.com/post_url" } } }, "issuer": { "type": "object", "properties": { "id": { "type": "string", "example": "bnk_TS052820221011q2O50709262" }, "name": { "type": "string", "example": "U.S. BANK, N.A." }, "country": { "type": "string", "example": "US" }, "region": { "type": "string", "example": "global" } } }, "activities": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "example": "activity_TS061320220959h2J50709738" }, "object": { "type": "string", "example": "activity" }, "created": { "type": "integer", "example": 1662544753039, "default": 0 }, "status": { "type": "string", "example": "INITIATED" }, "currency": { "type": "string", "example": "KWD" }, "amount": { "type": "integer", "example": 1, "default": 0 }, "remarks": { "type": "string", "example": "charge - created" } } } }, "auto_reversed": { "type": "boolean", "example": false, "default": true } } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```