Important Terminologies

There are a few terminologies within Card Acceptance that you should familiarize yourself with below

Card Registration Statuses

  • PENDING
    • This status is received when you hit Generate Webview API successfully, but card has not been binded successfully by the user
  • SUCCESS
    • Registration is considered as "SUCCESS" if user successfully authenticates and authorizes their card details. Merchant will then receive the card token from Ayoconnect.
  • UNBINDED
    • A previously successfully registered card has been unbinded successfully through the Card Unbinding API

Card Payment Statuses

  • SUCCESS
    • Payment is considered as "SUCCESS" when merchant received the success response from payment charge API.
    • "SUCCESS" status from payment can be triggered by the following: (For more information, please refer to section "Card Payment")
      • Success from 'PAY' operation
      • Success from 'CAPTURE' operation
  • PENDING
    • Payment is considered as "PENDING" if the final status of the payment has not been received from the bank
    • Pending is also the default state of the initial payment process
  • AUTHORIZED
    • "AUTHORIZED" is a status exist only in AUTH & CAPTURE flow.
    • Merchant will receive this status when they have successfully receive successful response of payment request with operation "AUTH".
    • Only transaction with this status can be processed by "CAPTURE" operation.
    • Merchants are also able to call VOID request to cancel the authorization made previously to end user card's limit.
  • VOIDED
    • Transaction will be considered as "VOIDED" when merchant successfully call VOID API.
    • Only "AUTHORIZED" can be voided using void API.
  • REFUNDED
    • Transaction that is previously success or captured can be refunded.
    • Currently there are no Refund API and all refund request will be done by Ayoconnect internally.
  • FAILED
    • Transaction will be considered as "FAILED" if merchant received error response from Ayoconnect.

Card Payment State Diagram