Create Incoming Transactions

1 curl -X POST https://rewards-api.getkard.com/v2/issuers/organization-123/transactions \ 2 -H "Authorization: Bearer <token>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "data": [ 6 { 7 "type": "transaction", 8 "attributes": { 9 "userId": "6FHt5b6Fnp0qdomMEy5AN6PXcSJIeX69", 10 "amount": 1000, 11 "status": "APPROVED", 12 "currency": "USD", 13 "description": "ADVANCEAUTO", 14 "cardBIN": "123456", 15 "cardLastFour": "4321", 16 "direction": "DEBIT", 17 "paymentType": "CARD", 18 "transactionId": "2467de37-cbdc-416d-a359-75de87bfffb0", 19 "subtotal": 800, 20 "description2": "ADVANCEAUTO", 21 "mcc": "1234", 22 "authorizationDate": "2021-07-02T17:47:06Z", 23 "merchant": { 24 "name": "ADVANCEAUTO", 25 "id": "12345678901234567", 26 "addrStreet": "125 Main St", 27 "addrCity": "Philadelphia", 28 "addrState": "PA", 29 "addrZipcode": "19147", 30 "addrCountry": "United States", 31 "latitude": "37.9419429", 32 "longitude": "-73.1446869", 33 "storeId": "12345" 34 }, 35 "authorizationCode": "123456", 36 "retrievalReferenceNumber": "100804333919", 37 "systemTraceAuditNumber": "333828", 38 "acquirerReferenceNumber": "1234567890123456789012345678", 39 "cardProductId": "1234567890123456789012345678" 40 }, 41 "id": "309rjfoincor3icno3rind093cdow3jciwjdwcm" 42 } 43 ] 44 }'

1 { 2 "data": { 3 "type": "job", 4 "id": "c94a93a7-beb9-4e58-960c-2c812f849398", 5 "attributes": { 6 "status": "queued", 7 "message": "Incoming Transactions event successfully queued for processing" 8 } 9 } 10 }

Call this endpoint to send all transactions made by all your enrolled users in your rewards program. The request body will depend on the transaction type.
Please use the correct type when calling the endpoint:

transaction: These incoming transactions will be processed and matched by the Kard system. Learn more about the Transaction CLO Matching flow here.
matchedTransaction: For pre-matched transactions that need validation on match by the Kard system.

Required scopes: transaction:write
Note: Maximum of 500 transactions can be created per request.

Call this endpoint to send all transactions made by all your enrolled users in your rewards program. The request body will depend on the transaction type. Please use the correct type when calling the endpoint: - `transaction`: These incoming transactions will be processed and matched by the Kard system. Learn more about the [Transaction CLO Matching](https://github.com/kard-financial/kard-postman#c-transaction-clo-matching) flow here. - `matchedTransaction`: For pre-matched transactions that need validation on match by the Kard system. Required scopes: `transaction:write` Note: `Maximum of 500 transactions can be created per request`.

Authentication

AuthorizationBearer

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

Path parameters

organizationIdstringRequired

Your issuer organization ID, provided by Kard

Request

This endpoint expects an object.

datalist of objectsRequired

Discriminated union representing the request body for submitting a transaction. Use type to distinguish between the two:

transaction: For transactions requiring processing and matching by the Kard system.
matchedTransaction: For pre-matched transactions that need validation on match by the Kard system.

Discriminated union representing the request body for submitting a transaction. Use `type` to distinguish between the two: - `transaction`: For transactions requiring processing and matching by the Kard system. - `matchedTransaction`: For pre-matched transactions that need validation on match by the Kard system.

Response

This endpoint returns an object.

dataobject

Authentication

Path parameters

Request

Response

Errors