EasyEuro OpenAPI
  1. TopUp
EasyEuro OpenAPI
  • Get started
  • Release Note
  • 01.Authentication
    • new token
      POST
  • 02.Webhook
    • Webhook Get Started
    • register a new webhook
      POST
    • delete webhook by id
      DELETE
    • query webhook by id
      GET
    • query registered webhook
      GET
    • callback notification demo
      GET
    • Mock Webhook Callback Event
      POST
  • 03.DocumentFile
    • create document file
      POST
    • upload document file
      POST
    • create and upload document file
      POST
    • page query document file
      GET
  • 04.OperationTicket
    • OperationTicket Get Started
    • new OperationTicket
      POST
    • reopen OperationTicket
      POST
    • get OperationTicket by id
      GET
    • page query OperationTicket
      GET
    • review OperationTicket
      POST
  • 10.Wallet
    • Wallet Get Started
    • create wallet
    • get wallet by id
    • page query wallets
    • modify wallet info
    • upload KYC file
    • submit for KYC
    • submit KYC doc files
    • submit onboarding-question-answer
    • submit onboard-question-answer
    • cancel wallet kyc
    • close wallet
    • sync sumsub shareToken
    • open IDV session
    • get IDV session detail
    • pass wallet KYC (sandbox only)
    • reject wallet KYC (sandbox only)
  • 11.BankAccount
    • BankAccount Get Started
    • query wallet accounts
    • create account
    • query account details by id
    • query funding account numbers
    • query account balance
    • query the account entry
    • query the account balance block entry
    • close account
  • 12.FundsIn
    • FundsIn Get Started
    • get funds in order
    • page query funds in orders
    • refund funds in order
    • accept funds in order
    • Mock Funds In
    • get funds in refund receipt
  • 13.SecureTransfer
    • SecureTransfer Get Started
    • new SecureTransfer
    • undo SecureTransfer
    • query SecureTransfer by id
    • page query SecureTransfer
    • submit file of reference orders
  • 14.TransferRecipient
    • Recipient Get Started
    • Create a SEPA recipient
    • Create a Crypto recipient
    • Create a FPS recipient
    • Create a SWIFT recipient
    • Create a CHATS recipient
    • Create a DKK local recipient
    • Create a ACH recipient
    • Upload recipient account proof
    • Query a recipient
    • Page query wallet recipients
  • 15.Transfer(PayOut)
    • Transfer Get Started
    • new transfer order
    • query transfer order by id
    • page query transfer orders
    • query transfer by requestId
    • get transfer receipt
  • 16.FundsSettlement
    • synchronize user business order
    • query custody balance
  • 20.Card-Issuing
    • Card-Issuing get started
    • Query Wallet Cardholder
    • Update Wallet Cardholder
    • Apply Virtual Card
    • Apply Physical Card
    • Activate Card
    • Lock Card
    • Unlock Card
    • Close Card
    • Query Card Txn Switch
    • Update Card Txn Switch
    • Update Card Cardholder
    • Page Query Card
    • Query Card
    • Query Card Secure Info
    • Query Card PIN
    • Increase Card Available Balance
    • Decrease Card Available Balance
    • Query Card Available Balance
    • Page Query Card Balance Operation Record
    • Approve Card 3DS Auth
    • Reject Card 3DS Auth
    • Query Card 3DS Auth
    • Query Card Transaction
    • Page Query Card Transaction
    • Query Card Transaction Action
    • Page Query Card Transaction Action
    • Mock Card Transaction
    • Mock Card Transaction 3DS Auth
    • Mock Card Transaction Operation
    • Card Transaction Authorization Relay
    • Request Card App Access Token
    • Get Card APP Application ID
  • 30.CardPayment
    • CardPayment Get Started
    • Payment
      • New Payment
      • New Direct Payment
      • Refund
      • Get Transaction By Id
      • Query Transactions
    • TopUp
      • Create a Top-up Transaction
        POST
      • Refund
        POST
      • Get Top-up Transaction by Id
        GET
      • Query Top-up Transactions
        GET
    • CardToken
      • Delete Bound Card Token
      • Get Card Token By Id
      • Query Card Tokens
    • FundsSettlement
      • Settlement Get Started
      • query settlement
      • query statements
      • download statement file
      • query unsettled amount
    • Notification
      • Card Transaction CallbackEvent
      • CardToken Bound Callback Event
    • dispute
      • Download Dispute File
  • 31.Forex
    • Forex Get Started
    • Get FX Rate
    • Get FX Quote
    • Create FX Order
    • Get FX Order
  • 32.Top-Up-Deleted
    • Top-Up Get Started
    • transaction
      • Create Top-up Order
      • Refund Top-up Order
      • Get Top-up Order
      • Get Top-up Action
      • Query Top-up Orders
      • Query Top-up Actions
    • settlement
      • Query Statements
      • download statement file
      • query settlement
      • query unsettled amount
  1. TopUp

Create a Top-up Transaction

Developing
POST
/card-payment/transaction/top-up
create a top-up transaction

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json

Example
{
    "requestId": "string",
    "clientOrderId": "string",
    "terminalId": "string",
    "consumer": {
        "consumerId": "string",
        "consumerName": "string",
        "consumerEmail": "string",
        "telephoneCountryCode": "string",
        "telephoneNumber": "string"
    },
    "currency": "string",
    "amount": "string",
    "card": {
        "cardBrand": "string",
        "cardHolderName": "string",
        "cardNumber": "string",
        "expiryDate": "string",
        "cvc": "string",
        "billingAddress": {
            "firstName": "string",
            "middleName": "string",
            "lastName": "string",
            "address1": "string",
            "address2": "string",
            "address3": "string",
            "postalCode": "string",
            "city": "string",
            "state": "string",
            "countryCode": "string",
            "telephoneCountryCode": "string",
            "telephoneNumber": "string"
        }
    },
    "threeDs": {
        "enabled": true,
        "challengeIndicator": "NO_PREFERENCE",
        "accountInfo": {
            "accountAge": "NO_ACCOUNT",
            "accountChange": "string",
            "accountPasswordChange": "string"
        }
    },
    "sender": {
        "type": "INDIVIDUAL",
        "firstName": "string",
        "lastName": "string",
        "companyName": "string",
        "dateOfBirth": "string",
        "address": {
            "address1": "string",
            "address2": "string",
            "city": "string",
            "postalCode": "string",
            "state": "string",
            "countryCode": "string"
        }
    },
    "recipient": {
        "firstName": "string",
        "lastName": "string",
        "accountNumber": "string",
        "dateOfBirth": "string",
        "address": {
            "address1": "string",
            "address2": "string",
            "city": "string",
            "state": "string",
            "postalCode": "string",
            "countryCode": "string"
        }
    },
    "description": "string",
    "shippingAddress": {
        "firstName": "string",
        "middleName": "string",
        "lastName": "string",
        "address1": "string",
        "address2": "string",
        "address3": "string",
        "postalCode": "string",
        "city": "string",
        "state": "string",
        "countryCode": "string",
        "telephoneCountryCode": "string",
        "telephoneNumber": "string",
        "emailAddress": "string"
    },
    "paymentIp": "string",
    "successUrl": "string",
    "failureUrl": "string"
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/card-payment/transaction/top-up' \
--header 'Content-Type: application/json' \
--data-raw '{
    "requestId": "string",
    "clientOrderId": "string",
    "terminalId": "string",
    "consumer": {
        "consumerId": "string",
        "consumerName": "string",
        "consumerEmail": "string",
        "telephoneCountryCode": "string",
        "telephoneNumber": "string"
    },
    "currency": "string",
    "amount": "string",
    "card": {
        "cardBrand": "string",
        "cardHolderName": "string",
        "cardNumber": "string",
        "expiryDate": "string",
        "cvc": "string",
        "billingAddress": {
            "firstName": "string",
            "middleName": "string",
            "lastName": "string",
            "address1": "string",
            "address2": "string",
            "address3": "string",
            "postalCode": "string",
            "city": "string",
            "state": "string",
            "countryCode": "string",
            "telephoneCountryCode": "string",
            "telephoneNumber": "string"
        }
    },
    "threeDs": {
        "enabled": true,
        "challengeIndicator": "NO_PREFERENCE",
        "accountInfo": {
            "accountAge": "NO_ACCOUNT",
            "accountChange": "string",
            "accountPasswordChange": "string"
        }
    },
    "sender": {
        "type": "INDIVIDUAL",
        "firstName": "string",
        "lastName": "string",
        "companyName": "string",
        "dateOfBirth": "string",
        "address": {
            "address1": "string",
            "address2": "string",
            "city": "string",
            "postalCode": "string",
            "state": "string",
            "countryCode": "string"
        }
    },
    "recipient": {
        "firstName": "string",
        "lastName": "string",
        "accountNumber": "string",
        "dateOfBirth": "string",
        "address": {
            "address1": "string",
            "address2": "string",
            "city": "string",
            "state": "string",
            "postalCode": "string",
            "countryCode": "string"
        }
    },
    "description": "string",
    "shippingAddress": {
        "firstName": "string",
        "middleName": "string",
        "lastName": "string",
        "address1": "string",
        "address2": "string",
        "address3": "string",
        "postalCode": "string",
        "city": "string",
        "state": "string",
        "countryCode": "string",
        "telephoneCountryCode": "string",
        "telephoneNumber": "string",
        "emailAddress": "string"
    },
    "paymentIp": "string",
    "successUrl": "string",
    "failureUrl": "string"
}'

Responses

🟢200OK
application/json
Body

Example
{
    "id": "string",
    "requestId": "string",
    "clientOrderId": "string",
    "merchantId": "string",
    "terminalId": "string",
    "consumer": {
        "consumerId": "string",
        "consumerName": "string",
        "consumerEmail": "string",
        "telephoneCountryCode": "string",
        "telephoneNumber": "string"
    },
    "type": "string",
    "currency": "string",
    "amount": 0,
    "redirectUrl": "string",
    "originalTransactionId": "string",
    "description": "string",
    "createdTime": "string",
    "updatedTime": "string",
    "status": "string",
    "failedReason": "string",
    "obfuscatedPan": "string"
}
Modified at 2025-02-28 03:30:49
Previous
Query Transactions
Next
Refund
Built with