Simulate a Card Transaction Authorization Request - EEA
Simulate Rapyd’s request to your authorization server.
If you have implemented Remote Authorization, Rapyd sends authorization requests to your remote authorization server when the card network requests approval of a transaction on a card issued to a Rapyd Wallet. Use this method in the sandbox.
The response contains all the fields you must send to Rapyd when you receive an authorization request in production. See also Remote Authorization.
When financial_impact is set to credit, this method triggers Card Issuing Credit Webhook. When financial_impact is set to debit, this method triggers Card Issuing Authorization Approved Webhook. Funds in the wallet move from available balance to on-hold balance. See Wallet Balance Types.
To simulate deducting the funds from the wallet, run Simulate Clearing a Card Transaction - EEA.
This method applies to cards issued in the European Economic Area (EEA). For cards issued outside the EEA, see Simulate a Card Transaction Authorization Request - Non-EEA.
Prerequisites
A company wallet with a personal contact.
amount
The amount of the authorization, in units of the currency defined in
currency. Decimal.
card_id
ID of the card. String starting with card_.
currency
The currency supported by the card. Three-letter ISO 4217 code.
financial_impact
Indicates the financial impact of the transaction. One of the following:
credit
debit.
/v1/issuing/cards/authorization
Card Transaction Authorization - Credit
curl -X post https://sandboxapi.rapyd.net/v1/issuing/cards/authorization -H 'access_key: your-access-key-here' -H 'Content-Type: application/json' -H 'idempotency: your-idempotency-parameter-here' -H 'salt: your-random-string-here' -H 'signature: your-calculated-signature-here' -H 'timestamp: your-unix-timestamp-here' -d '{ "card_id": "card_c0acb5d35a78fcf4473bc98b1cda8cf9", "amount": 3, "currency": "EUR", "financial_impact": "credit" } '{ "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "99767bce-82be-5b9c-8278-28be6c6b23b2" }, "data": { "id": "cardauth_e7aeb2b52e667d3e6deccbe7c54e6851", "card_id": "card_c0acb5d35a78fcf4473bc98b1cda8cf9", "card_transaction_id": "cit_d13763c102de24673b92882c4e482dea", "amount": 3.58, "currency_code": "USD", "txn_type": "CREDIT", "auth_response": { "code": "00", "message": "APPROVED_OR_COMPLETED_SUCCESSFULLY" }, "is_remote_auth": false, "remote_auth_endpoint": "", "remote_auth_response": null, "transaction_amount": 3, "transaction_currency_code": "EUR", "fx_rate": null, "merchant_category_code": "", "merchant_name_location": "TEST MERCHANT", "merchant_identification_code": "#RAPYD SANDBOX#" } }
Card Transaction Authorization - Debit
curl -X post https://sandboxapi.rapyd.net/v1/issuing/cards/authorization -H 'access_key: your-access-key-here' -H 'Content-Type: application/json' -H 'idempotency: your-idempotency-parameter-here' -H 'salt: your-random-string-here' -H 'signature: your-calculated-signature-here' -H 'timestamp: your-unix-timestamp-here' -d '{ "card_id": "card_c0acb5d35a78fcf4473bc98b1cda8cf9", "amount": 3, "currency": "EUR", "financial_impact": "debit" } '{ "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "86799ebc-91ae-4a8b-9389-19cf7e7a32a1" }, "data": { "id": "cardauth_d8bdc1a61f558c2f7edcbbc8b45f1586", "card_id": "card_c0acb5d35a78fcf4473bc98b1cda8cf9", "card_transaction_id": "cit_c36731a201de37642c28829b3d284ead", "amount": 3.58, "currency_code": "USD", "txn_type": "SALE", "auth_response": { "code": "00", "message": "APPROVED_OR_COMPLETED_SUCCESSFULLY" }, "is_remote_auth": false, "remote_auth_endpoint": "", "remote_auth_response": null, "transaction_amount": 3, "transaction_currency_code": "EUR", "fx_rate": null, "merchant_category_code": "", "merchant_name_location": "TEST MERCHANT", "merchant_identification_code": "#RAPYD SANDBOX#" } }