PaymentRequests

Gets a payment request by its order ID.

<b>Authorization</b>: Merchant token is required.

get/api/v1/paymentrequests/getbyorderid/{orderID}

Request

  • Base URL: https://api.nofrixion.com
  • URL: https://api.nofrixion.com/api/v1/paymentrequests/getbyorderid/{orderID}
  • Auth: API key in header Authorization

Path parameters

orderIDstring required

The order ID of the payment request to retrieve. Useful when the payment request has been created by an external application such as WooCommerce or Xero.

Response

Returns a payment request record.

idstring uuid
merchantIDstring uuid
amountnumber double

The amount of money to request.

currency'NONE' | 'GBP' | 'EUR' | 'USD' | 'AUD' | 'BGN' | 'CAD' | 'CZK' | 'DKK' | 'HUF' | 'ISK' | 'CHF' | 'NOK' | 'PLN' | 'RON' | 'AED' | 'CNH' | 'HKD' | 'ILS' | 'JPY' | 'MXN' | 'NZD' | 'SAR' | 'SEK' | 'SGD' | 'TRY' | 'ZAR' | 'BTC'

The currency of the request.

customerIDstring nullable

An optional customer identifier for the payment request.

orderIDstring nullable

An optional order ID for the payment request. If the request is for an invoice this is the most appropriate field for the invoice ID.

paymentMethodsstring[] nullable

The payment methods that the payment request supports.

descriptionstring nullable

An optional description for the payment request. If set this field will appear on the transaction record for some card processors.

pispAccountIDstring uuid nullable

The payment account ID to use to receive payment initiation payments. This must match one of your NoFrixion payment account IDs. This can be left blank to use your default payment account.

baseOriginUrlstring nullable

For card payments the origin of the payment page needs to be set in advance. A public key context is generated to encrypt sensitive card details and is bound to a single origin URL.

callbackUrlstring nullable

Once a payment is processed, or a notification of an inbound payment is received, a callback request will be made to this URL. Typically it will be the page on a merchant's web site that displays the results of the payment attempt.

failureCallbackUrlstring nullable

Optional callback URL for payment failures that can occur when the payer is redirected away from the payment page. Typically the payer is only sent away from the payment page for pay by bank attempts. If this URL is not set the payer will be redirected back to the original URL the payment attempt was initiated from.

successWebHookUrlstring nullable

If a payment event results in the payment request being classified as fully paid this success webhook URL will be invoked. The URL will be invoked as a GET request, i.e. there will be no request body. Two query parameters will be added to the URL. The first one will be "id" and will hold the payment request ID. The second one will be "orderid" and will hold the payment request OrderID, note the OrderID could be empty if it was not set when the payment request was created. The recommended approach when receiving a success web hook is to use the "id" parameter to call the moneymoov get payment request endpoint to retrieve the full details of the payment request and check the status. Web hooks can be easily spoofed and should not be relied upon.

cardAuthorizeOnlyboolean

For card payments the default behaviour is to authorise and capture the payment at the same time. If a merchant needs to authorise and then capture at a later point this property needs to be set to true.

cardCreateTokenboolean

For card payments a payment attempt can be used to create a reusable token for subsequent payments. Setting this field to true will create a reusable customer token.

cardCreateTokenMode'None' | 'ConsentNotRequired' | 'UserConsentRequired'

This specifies whether user consent will be taken before tokenising card or not. If this is set to 'UserConsentRequired' then, the user consent will potentially update CardCreateToken flag on submit card payment.

ignoreAddressVerificationboolean

If set to true the card payment gateway will be directed to proceed with a payment even if the address verification checks fails.

cardIgnoreCVNboolean

If set to true the card payment gateway will be directed to proceed with a payment even if the card verification number check fails.

cardProcessorMerchantIDstring nullable

Optional field that if specified indicates the processor merchant ID that should be used to process any card payments. Mainly useful where a merchant has multiple processor merchant ID's. If left empty the default merchant card settings will be used.

paymentProcessor'None' | 'CyberSource' | 'Checkout' | 'Stripe' | 'Modulr' | 'Plaid' | 'Yapily' | 'Nofrixion' | 'Bitcoin' | 'BitcoinTestnet' | 'BankingCircle' | 'BankingCircleAgency' | 'Simulator' | 'Lightning' | 'LightningTestnet' | 'BankingCircleDirectDebit' | 'Technoxander'

If the card payment option is enabled this field indicates which card processor the merchant is set up to use.

lightningInvoicestring nullable

Bitcoin Lightning invoice for the payment request.

status'None' | 'FullyPaid' | 'PartiallyPaid' | 'OverPaid' | 'Voided' | 'Authorized'

The current status of the payment request. Will be set to FullyPaid when the full amount has been received.

hostedPayCheckoutUrlstring nullable

This is a convenience link generated for payment requests whose merchants are using hosted payment pages. The link will load the MoneyMoov hosted payment page. If the merchant has not been set up for hosted payment or the payment can't be hosted then this property will be empty.

partialPaymentMethod'None' | 'Partial'

The approach to use, or not, for accepting partial payments.

insertedstring date-time

The timestamp the payment request was created at.

insertedSortablestring nullable
lastUpdatedstring date-time

The timestamp the payment request was last updated at.

useHostedPaymentPageboolean

If set to true, and the merchant is configured for hosted payment pages, the base and callback URLs will be set to use the hosted payment page.

customerEmailAddressstring email nullable

Optional email address for the customer. If the tokenise card option is set then the customer email address is mandatory.

cardStripePaymentIntentIDstring nullable

If Stripe is being used as the card payment processor this property is used to hold the Stripe payment intent ID.

cardStripePaymentIntentSecretstring nullable

If Stripe is being used as the card payment processor this property is used to hold the Stripe payment intent client secret.

jwkstring nullable

The jwk containing the public key used to verify the signature of the payment request.

priorityBankIDstring uuid nullable

The ID of the bank that is set as the priority bank for display on pay element.

titlestring nullable

A generic field to contain any additional data that the merchant wishes to store against the payment request. E.g. product or service information.

partialPaymentStepsstring nullable

An optional comma separated list of partial payment amounts. The amounts represent guidance, or suggestions, as to how the payer will be requested to make partial payments.

payrunIDstring uuid nullable

The ID of a payrun that needs an account top up. Payment request can be used to top up payrun accounts.

notificationEmailAddressesstring nullable
amountReceivednumber double

Total amount received for this payment request.

amountRefundednumber double

Total amount refunded for this payment request.

amountPendingnumber double

Total amount that has been authorised but not settled for this payment request.

merchantTokenDescriptionstring nullable

Description of the merchant token in case the Payment request was created using a merchant token.

formattedAmountstring nullable
lightningInvoiceExpiresAtstring date-time nullable

Date and time of expiration of the lightning invoice.

autoSendReceiptboolean

If set to true, a receipt will be automatically sent to the CustomerEmailAddress when payments are received.

sandboxSettleDelayInSecondsinteger nullable

Sandbox only. Optional. If set, simulated settlements will be delayed by the specified number of seconds.

dueDatestring date-time nullable

The due date for the payment request.

notificationRoleIDsstring[] nullable

A list of roles whose members will receive notifications about this payment request.

merchantDirectDebitMandateIDstring uuid nullable

Optional ID of the direct debit mandate associated with this payment request.

isArchivedboolean

Indicates whether the payment request is archived.

customerNamestring nullable

Changes

No recorded changes to this endpoint across all 2 revisions of this API.