Gateway specific information for invoice numbers
Reference guide for how each payment gateway handles invoice numbers in Recurly — including character limits, truncation behavior, and gateway-specific attribute mappings.
Each payment gateway imposes its own character limits and handling rules for invoice numbers. When an invoice number exceeds a gateway's limit, Recurly left-truncates it to meet the maximum character requirement. Some gateways also use invoice numbers for additional gateway attributes, with their own separate limits.
Prerequisites
- Access to one or more supported payment gateways.
Limitations
- Each gateway has its own character limit for invoice numbers and gateway attributes. Limits are listed in the table below.
Invoice number limits by gateway
Invoice numbers that exceed a gateway's character limit are left-truncated to meet the maximum. Some gateways use invoice numbers for additional attributes that carry their own separate limits.
| Gateway | Max characters | Special considerations |
|---|---|---|
| FreedomPay | 17 | — |
| Chase Orbital | 22 | — |
| CardConnect | 36 | — |
| Check Commerce | 40 | — |
| Worldpay | 100 | — |
| Vantiv | 17 / 25 | Purchases and refunds use the invoice number (left-truncated if over 25 characters). Other transactions use the transaction UUID (left-truncated if over 25 characters). invoiceNumberReference is set to invoiceNumber. Customer reference is set to invoice number (left-truncated if over 17 characters). |
| TSYS | 15 | If the invoice number is empty, falls back to PO Number. |
| PayPal | 127 | Applies to PayPal Business, PayPal UK, and PayPal Complete. INVNUM is left-truncated to 127 characters if over limit. |
| Stripe | 25 | For invoice numbers over 25 characters: Level 3 merchant reference is left-truncated to 25 characters; Level 3 customer reference is left-truncated to 17 characters. For invoice numbers of 17 characters or fewer: full invoice number used for metadata.invoiceNumber, Level 3 merchant reference, and Level 3 customer reference. |
| Authorize.Net | 20 | PO Number left-truncated to 25 characters. Order.InvoiceNumber left-truncated to 20 characters. |
| Adyen | 25 | merchantOrderReference accepts full invoice number up to 1,000 characters. enhancedSchemeData.customerReference left-truncated to 25 characters. |
| Amazon Pay V1 | 128 | OrderReferenceAttributes.SellerOrderAttributes.SellerOrderID and SellerOrderAttributes.SellerOrderId left-truncated if over 128 characters. |
| Braintree | 127 | Invoice number left-truncated if over 128 characters for OrderId. purchaseOrderNumber left-truncated if over 12 characters. |
| CyberSource | Varies by processor | Asia, Middle East, and Africa: 40 characters. China UnionPay: 40 characters. Elavon Americas: 39 characters. FDC Nashville Global: 8 characters. All other processors: 8 characters. |
Updated 11 days ago
Did this page help you?