You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 15 Next »

For Order Payments Only

This reference guide relates only to single use PayID order payments. Azupay PayID currently cannot be used for account payments. 

Learn more: Azupay PayID

Azupay PayID & Orders

A PayID is a unique single use 'email address' generated for a specific payment request for a specific order (number). The customer uses the PayID to make a PayID bank transfer in their bank account. 


PayID for order payments has been implemented to make sure it can only be used for a one-off payment for a specific order.


A generated PayID is:  

  • unique: 'email' string is randomly generated by Azupay for a specific payment request tied to a specific order

  • single-use: can only be used once successfully before being deactivated

  • amount-controlled: payer entered bank transfer amount must match the payment request's 

  • time-limited: unused PayID will expire and be deactivated

    • Azupay's maximum and default expiry is 48 hours (2880 mins)

    • CV ecommerce's default expiry is is 48 hours (2880 mins). (You can change the expiry in CMS Azupay settings. But note that bank security checks can delay payment completion and a PayID needs to be active when the bank sends payment confirmation to Azupay.

    • If a PayID is deactivated, payment is automatically rejected (refunded back to source) by Azupay.  

  • requested to be deleted by your site when:

    • the user selects the Cancel button on the Azupay popup during checkout

    • the user session times out (session time outs)

    • the expiry passes.

NOTE - Once the payment has been completed, the associated PayID is de-registered automatically and deleted after 12 months. You can still search for it after 12 months in the Azupay dashboard.


On this page:

PayID & Order Payments

When your customer selects to pay by PayID, your system sends Azupay a request that contains:

  • your Azupay client ID
  • the client transaction ID (order number) 
  • payment description (reference added in the Azupay dashboard about payment. Default: your business + order number)
  • payment amount

Azupay's response contains the above and also:

  • the PayID
  • the payment request ID
  • request creation date and time
  • payID expiry date/time
  • payment request status (WAITING)

At checkout, the customer sees only the PayID but that is only one part of the whole PayID request record. The record has a unique identifier - Payment Request ID.

PayID Payment Tracking

It is possible for more than one PayID to be generated per order. For example, the user selects to pay by PayID and the payment request generates a PayID. They click Cancel, automatically deactivating that PayID. They select PayID as payment again. A new PayID request is generated with a new PayID. 


To track which payment request was used to pay for an order, it is best to track or verify payment using the Payment Request ID. This ID is always linked to a specific PayID and is included in any payment update sent or received by Azupay. In CV ecommerce, it is added in PayID payment notification emails to customers and as part of the PayID payment record on the Release Payments page.

For full details of the bank transfer transaction, use the Azupay Dashboard.

PayID Payment Statuses

Azupay marks one of these statuses against a generated PayID instance:

  • COMPLETE - the PayID was used to successfully pay for the order and Azupay has received confirmation from the payer's bank

    • NOTE - the PayID Payment Request record with 'complete' status also includes: completed date/time, amount received, payer entered reference (if any)  
  • WAITING - the PayID was generated against the order BUT Azupay has not yet received confirmation from the payer's bank AND the PayID has not expired. 

    • NOTE -  you can only delete a PaymentRequest that is in WAITING status

  • EXPIRED - no acceptable payment was received before the PaymentRequest expired
  • RETURN_IN_PROGRESS - a payment was received but is in the midst of being returned to the source account
  • RETURN_COMPLETE - the payment was returned to the source account

PayID Emails

The system provides four PayID customer notification emails that are auto-scheduled to send when certain PayID payment events occur. They provide your customer with their PayID payment record and any status updates. You can also set these emails to be bcc'ed to relevant team members so they receive updates without having to log in to the Azupay dashboard. 

All emails include the PayID and its Payment Request ID for internal tracking and payment enquiries by customers.  See: Azupay PayID Emails 

Release Payments

Coming soon

Your team members can manually release or reject a PayID payment, or check its status by using the Release Payments feature. Search by receipt number or order/invoice number. Payment details include the Payment Request ID.

 

  • No labels