Create Order
This endpoint allows you to create a new order. Orders are used in Paybyrd Checkout or the Pay By Link feature.
Authorizations
Body
Total amount for this transaction in ISO format, with the following pattern "2500" (to express 25.00)
Valid ISO-4217 alpha code e.g EUR
"EUR"
Merchant reference for this order
"ABC123456"
Show child attributes
Show child attributes
- Product
- Travel
- Travel with stay
Show child attributes
Show child attributes
Defines settings for this order
Show child attributes
Show child attributes
Defines settings for payment.
Show child attributes
Show child attributes
Metadata allows you to pass any data to Paybyrd which will be returned in the order query and also sent in the status changed notifications.
{ "key1": 1, "key2": "value" }
Response
201
Total amount for this transaction in ISO format, with the following pattern "2500" (to express 25.00)
Valid ISO-4217 alpha code e.g EUR
"EUR"
Merchant reference for this order
"ABC123456"
This field contains the unique identifier that represents the order.
"e901d7fa-a41a-4c93-bc53-7a08cd72aff4"
Order creation date in UTC
"2021-05-31T22:04:31Z"
Order expiration date in UTC, which is the sum of 'sessionExpiresIn' with 'expiresIn' parameters.
"2021-05-31T22:04:31Z"
Represents the status of the order. Created - Order has no payments associated to it or all payment attempts have failed. Pending - Order has a payment associated to it which is in progress but not concluded. Paid - Order has a payment associated to it with final status 'Success'. Canceled - This status can occur by system routines, shopper action by clicking on 'cancel payment' button in the hosted page or by calling the order cancel endpoint. Expired - This status occurs by system routines that checks for payment abandonment or in case an expiration date is sent in the create order request. Refunded - In case a successful payment is refunded, its order will have the 'Refunded' status.
created, paid, pending, refunded, canceled, expired "created"
The checkoutUrl is the direct link to Paybyrd Checkout. You can use it in your ecommerce to display the payment page to the shopper.
"https://chk.paybyrd.com/chk_fG3F6muPB"
Show child attributes
Show child attributes
- Product
- Travel
- Travel with stay
Show child attributes
Show child attributes
Defines settings for this order
Show child attributes
Show child attributes
Defines settings for payment.
Show child attributes
Show child attributes
Metadata allows you to pass any data to Paybyrd which will be returned in the order query and also sent in the status changed notifications.
{ "key1": 1, "key2": "value" }
Represents the Paybyrd code of the web request. To see more details check in Return Codes [blocked] page.
BYRD010, BYRD200, BYRD201, BYRD203, BYRD205, BYRD206, BYRD207, BYRD208, BYRD230, BYRD231, BYRD240, BYRD290, BYRD291, BYRD292, BYRD294, BYRD299, BYRD401, BYRD403, BYRD900, BYRD901, BYRD999 "BYRD200"
Represents a textually the description of the Paybyrd code of the web request. To see more details check in Return Codes [blocked] page
Request accepted, Operation successfully completed, Payment being processed. Waiting for shopper, An error occurred while processing the payment. Please query the transaction to confirm its status, Operation rejected, Operation blocked by velocity, Pending redirect, Payment canceled by the shopper, Payment already refunded, The refund amount exceeds the remaining balance of the original payment, Token is expired, An error occurred while pre processing the transaction. Please review your request and try again, An error occurred during while preparing transaction for acquiring. Please review your request and try again, No payment methods available for this operation. Please contact Paybyrd's support, Transaction could not be updated. Please review your request and try again, Operation could not be completed. Please review your request and try again, Resource access is forbidden, Resource access unauthorized, Invalid input, Resource not found, Operation failed "Operation successfully completed"