Guides

Step 4 - Create a Transaction

Suggest Edits

Create a Transaction

Now that you have linked a bank account from your user, you will be able to create a transaction, which moves funds from your user's linked bank account to your merchant account.

This step will go over how to create a payout transaction.

Create a Transaction Workflow

You will need to retrieve the user to check for their linked bank account. Refer to the previous step to learn more.

Create the Standard Transaction

HTTP request

Sandbox - POST https://staging-api.aeropay.com/transaction
Production - POST https://api.aeropay.com/transaction

Request parameters

ParameterRequired?TypeDescription
amount YesStringAmount of money.
Maximum limit: Default setting for configured in merchant portal or as defined in your Aeropay agreement.
Minimum limit: $0.01.
bankAccountIdnoStringBankAccountId of user. Defaults to user's selected bank
uuidnoStringThis unique uuid value will be associated with the transaction, and can be used to associate Aeropay transactions with your own system. Required for X-AP-Version: 2023-06-05. Please note, you must generate the UUID according to the standard methods (ISO/IEC 9834-8)

Code Example - Request

curl --request POST \
     --url https://staging-api.aeropay.com/transaction \
     --header 'Content-Type: application/json' \
     --header 'X-AP-Version: 2023-06-05' \
     --header 'accept: application/json' \
     --header 'authorizationToken: Bearer {{token}}' \
     --data '
{
  "attributes": {
    "tip": {
      "selection": {
        "tipAmount": "1.00",
        "label": "$1.00",
        "totalAmount": "11.00"
      }
    }
  },
  "amount": "10.00",
  "merchantId": "12345",
  "uuid": "transaction-UUID-in-v4-format"
}
'

👍

New transaction version!

As of 2023, we have added a new transaction version X-AP-Version: 2023-06-05 which is recommended for all clients to ensure the fastest and most efficient transaction creation.

🚧

Transaction UUIDs

Transaction uuids are used to associate Aeropay transactions with your own system, and must be unique to every transaction. Any transactions sent with duplicated uuids will be blocked by our system.

HTTP status and error codes

HTTP StatusError CodeMeaningResolutionMessage
200AP110: Missing user infoUser is missing required info to transactVerify user has valid first and last names, email and phone number"Unable to complete transaction due to incomplete user profile."
200AP109: User is disabledThe user either has an outstanding declined transaction or they were flagged during Aeropay’s identity screening. Refer to user.userStatus for more infoThe user should email [email protected] if they’ve made payments. If they are a new user, they should contact [email protected]"Sorry, your account is suspended. Please reach out to [email protected] to resolve the issue."
200AP300: Bank Connection ErrorThe balance refresh of this user’s account failed. This is usually caused by the user resetting their banking password or security settings within online banking. Balances will also become stale within 6-12 monthsThis is called a UAR (User-Action Required) error where the user must reconnect their account or contact Aeropay where we will assess if we can override their balance check."We are having issues connecting to your bank. Reconnect your bank or reach out to [email protected] to resolve the issue."
200AP302: Insufficient FundsThe user’s current balance does not meet the transaction amount. Pending transactions in the user’s account may be attributing to the balance they think they have.The user must deposit additional funds into their connected account. (This may take 1-2 business days to be reflected)"Available balance does not meet requirement - contact [email protected] for more information."
200AP305: User is disabledSpecific to /payoutTransaction: The user either has an outstanding declined transaction. Refer to user.userStatus for more infoThe user should email [email protected] if they’ve made payments. If they are a new user, they should contact [email protected]"Account disabled. Contact [email protected] to resolve the issue."
200AP307: Transaction Not ApprovedAeropay’s machine learning model did not approve the transaction after assessing its likelihood to decline.The user may contact the Aeropay Team for a possible override at [email protected]"Your payment was not approved by our monitoring system. Please try a different amount, connecting a different bank account, or contact [email protected] for more information."
200AP400: User missing bank accountUser has no banks connected and cannot transactConnect a bank account for user"No bank account for provided user id."
200AP401: Invalid bank account idBank account id does not belong to user attempting to transactProvide valid bankAccountId or remove bankAccountId param and transaction will use user's default bank account"Bank account does not belong to user."
200AP412: Bank account removedBank account has been removed from users accountProvide valid bankAccountId or remove bankAccountId param and transaction will use user's default bank account"Bank account has already been removed"

Updated 3 months ago