Payments
...
Transaction mgmt APIs
Pull transaction by ID
1 min
{ "name" "endpoint /api/pulltransaction/{transactionid}", "method" "get", "url" "https //pullfromcardapistg crbnj net/api/pulltransaction/{transactionid}", "description" "returns details of a specific transaction where a merchant (the payee) takes funds from an end consumer (the payer) use the transactionid attribute as the transaction identifier ", "tab" "examples", "examples" { "languages" \[ { "id" "gtxlkbmp14hqhyjjrjmkw", "language" "curl", "code" "curl x \nget \n header 'accept application/json' \n header 'authorization bearer token' \n'https //pullfromcardapistg crbnj net/api/transaction/230bc14b 970b 4ee2 8fd3 1911d51f89d4'", "customlabel" "" } ], "selectedlanguageid" "gtxlkbmp14hqhyjjrjmkw" }, "results" { "languages" \[ { "id" "u4wdyehcip7vkukdpfeng", "language" "200", "customlabel" "", "code" "{\n \\"transactionrequestid\\" \\"ji7abzpy 8xp3 gpby 2604 jab7tpxy36tp\\",\n \\"amount\\" 400,\n \\"transactionrequestedat\\" \\"2021 08 03t21 09 13 5882004z\\",\n \\"transactionstatus\\" \\"succeeded\\",\n \\"errordescription\\" null,\n \\"creditcardid\\" \\"kr7d47mnjil2r39oznrvpc0dis82es8je6j7vu\\",\n \\"railid\\" \\"tabapay\\",\n \\"network\\" \\"mastercard\\",\n \\"retrievalreferenceid\\" \\"8abcb1fa 51f1 4b2d 9998 5948877bdcc0\\",\n \\"actualtransactiondoneat\\" \\"2021 08 03t21 09 13 937108z\\",\n \\"requestapproved\\" true,\n \\"responsereceived\\" true,\n \\"responsecode\\" \\"00\\",\n \\"responsedescription\\" \\"approved\\",\n \\"tracenumber\\" \\"hl7a9zpg 8zpy 92po bhp2 xhpg5804pz2k\\",\n \\"error\\" null,\n \\"requestername\\" null,\n \\"requestermcc\\" null\n \\"issuccessful\\" true\n}" } ], "selectedlanguageid" "u4wdyehcip7vkukdpfeng" }, "request" { "pathparameters" \[ { "name" "transactionid", "kind" "required", "type" "string", "description" "a unique string (32 hexadecimal characters) that identifies the transaction in a definite way the payment card network passes this identifier, without changing it, throughout the whole interbank chain ", "" "required" } ], "queryparameters" \[ { "name" "requesterid", "kind" "optional", "type" "string", "description" "the merchant partner unique identifier 32 hexadecimal characters ", "" "optional" } ], "headerparameters" \[], "bodydataparameters" \[], "formdataparameters" \[] }, "currentnewparameter" { "label" "query parameter", "value" "queryparameters" }, "response" \[ { "name" "transactionrequestid", "kind" "optional", "type" "string", "description" "unique customer generated transaction request" }, { "name" "amount", "kind" "optional", "type" "integer", "description" "the amount to be transferred, in cents for example, 10001 = $100 01 \n\nif the consumer is enabled for partial authorization, this field will present the actual amount approved by the card issuer (that was pulled from the cardholder account) ", "children" \[] }, { "name" "originalamount", "kind" "optional", "type" "integer", "description" "this attribute appears in a partially authorized aft transaction \n\nthe original transaction amount (amount value in the aft request), represented in the transaction currency (sendercurrencycode value in aft request) \n\nif partial authorization is not enabled, the value be the requested and approved transaction amount ", "children" \[] }, { "name" "transactionrequestedat", "kind" "optional", "type" "string", "description" "date and time of the request (gmt)", "children" \[] }, { "name" "transactionstatus", "kind" "optional", "type" "string", "description" "transaction status \n\n pending\n succeeded \n failed\n rejected", "children" \[] }, { "name" "errordescription", "kind" "optional", "type" "string", "description" "a description of the error, if relevant", "children" \[] }, { "name" "creditcardid", "kind" "optional", "type" "string", "description" "card token of the signed up debit card", "children" \[] }, { "name" "railid", "kind" "optional", "type" "string", "description" "the payment processor used to perform the transaction \n\n rs2\n mcsend\n tabapay\n visadirect", "children" \[] }, { "name" "network", "kind" "optional", "type" "string", "description" "name of the payment card network", "children" \[] }, { "name" "retrievalreferenceid", "kind" "optional", "type" "string", "description" "the number cross river creates that is passed to the rail to assist in tracing a transaction after it left our system", "children" \[] }, { "name" "actualtransactiondoneat", "kind" "optional", "type" "string", "description" "the date and time the transaction was sent to the payment processor", "children" \[] }, { "name" "requestapproved", "kind" "optional", "type" "boolean", "description" "true if a request was approved, otherwise false", "children" \[] }, { "name" "responsereceived", "kind" "optional", "type" "boolean", "description" "true if a response was received, otherwise false", "children" \[] }, { "name" "responsecode", "kind" "optional", "type" "string", "description" "a 2 digit code signifying the transaction result (approved or decline) for example, 00 means successful ", "children" \[] }, { "name" "responsedescription", "kind" "optional", "type" "string", "description" "a string describing the transaction result for example, approved ", "children" \[] }, { "name" "tracenumber", "kind" "optional", "type" "string", "description" "a unique number assigned to a transaction from the time it leaves the merchant bank until it arrives at the cardholder bank", "children" \[] }, { "name" "error", "kind" "optional", "type" "string", "description" "a description of the error, if relevant", "children" \[] }, { "name" "requestername", "kind" "optional", "type" "string", "description" "merchant name", "children" \[] }, { "name" "requestermcc", "kind" "optional", "type" "string", "description" "merchant category code (mcc) 4 digits that a credit card issuer uses to categorize consumer transactions for their card ", "children" \[] }, { "name" "programid", "kind" "optional", "type" "string", "description" "connects a transaction to a given sub merchant network program id (visa mvv, mastercard mcid)", "children" \[] }, { "name" "businesstype", "kind" "optional", "type" "string", "description" " one of bb, fd, aa, pp, bi, cd, ft, wt, cp", "children" \[] } ] }