Skip to main content

Documentation

Simulate a Card Transaction Adjustment - EEA

Use this method in the sandbox to simulate an adjustment to a card transaction. A retail location can adjust the amount of a transaction made by an issued card. The adjustment is either a credit or a debit. This method triggers Card Issuing Adjustment Webhook. This method updates the available balance of the wallet with the credit or deduction. See Wallet Balance Types. This method applies to cards issued in the European Economic Area (EEA).

Prerequisites:

    • amount

    • The amount of the adjustment, in units of the currency defined in currency. Decimal.

    • card_id

    • ID of the card. String starting with card_.

    • currency

    • The adjustment currency. Three-letter ISO 4217 code.

    • financial_impact

    • Indicates the financial impact of the adjustment. One of the following: credit, debit.

  • /v1/issuing/cards/adjustment

  • Card Transaction Adjustment - Credit

  • curl -X post
    https://sandboxapi.rapyd.net/v1/issuing/cards/adjustment
    -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": 2,
      "currency": "USD",
      "authorization_id": "cardauth_2acf298ae9e27a2596569db1e0c53a14",
      "financial_impact": "credit"
    }
    '
    
  • {
        "status": {
            "error_code": "",
            "status": "SUCCESS",
            "message": "",
            "response_code": "",
            "operation_id": "e82e2b7b-2554-4395-8b6c-cebe937786ad"
        },
        "data": {
            "id": "cardauth_5099979e9032bf4e423fdeb353e9b7f3",
            "card_id": "card_c0acb5d35a78fcf4473bc98b1cda8cf9",
            "card_transaction_id": "cit_4385eb56bf4e6b97b2f29376499f7881",
            "amount": 2,
            "currency_code": "USD",
            "txn_type": "ADJUSTMENT",
            "auth_response": {
                "code": "00",
                "message": "APPROVED_OR_COMPLETED_SUCCESSFULLY"
            },
            "is_remote_auth": false,
            "remote_auth_endpoint": "",
            "remote_auth_response": null,
            "transaction_amount": 2,
            "transaction_currency_code": "USD",
            "fx_rate": null,
            "merchant_category_code": "",
            "merchant_name_location": "TEST MERCHANT",
            "merchant_identification_code": "#RAPYD SANDBOX#"
        }
    }
  • Card Transaction Adjustment - Debit

  • curl -X post
    https://sandboxapi.rapyd.net/v1/issuing/cards/adjustment
    -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": 2,
      "currency": "USD",
      "authorization_id": "cardauth_2acf298ae9e27a2596569db1e0c53a14",
      "financial_impact": "debit"
    }
    '
    
  • {
        "status": {
            "error_code": "",
            "status": "SUCCESS",
            "message": "",
            "response_code": "",
            "operation_id": "f93c1a5a-1445-4824-9c5b-bfcd687739da"
        },
        "data": {
            "id": "cardauth_9799905b3209fb4f324dfbe242b8d8e2",
            "card_id": "card_c0acb5d35a78fcf4473bc98b1cda8cf9",
            "card_transaction_id": "cit_bb48be88fb5f7a79e1e99467392b8718",
            "amount": 2,
            "currency_code": "USD",
            "txn_type": "ADJUSTMENT",
            "auth_response": {
                "code": "00",
                "message": "APPROVED_OR_COMPLETED_SUCCESSFULLY"
            },
            "is_remote_auth": false,
            "remote_auth_endpoint": "",
            "remote_auth_response": null,
            "transaction_amount": 2,
            "transaction_currency_code": "USD",
            "fx_rate": null,
            "merchant_category_code": "",
            "merchant_name_location": "TEST MERCHANT",
            "merchant_identification_code": "#RAPYD SANDBOX#"
        }
    }