Copy PageAdd Subscriptionpost https://securelink-staging.valorpaytech.com:443/?addSubsRecent RequestsLog in to see full request historyTimeStatusUser Agent Retrieving recent requests…LoadingLoading…Body ParamsappidstringrequiredDefaults to h6tSvf0Cz7fSB86B44bkLEplS15AsWYoMerchant APP ID (Alphanumeric - Length of 32 chars)appkeystringrequiredDefaults to zOKj0LUOiW4L9jFRrMbMiJQ5KxQEpSMmMerchant APP KEY (Alphanumeric - Length of 32 chars and special chars $@%#)epistringrequiredDefaults to 2412333540EPI is an end point identifier, Identify the device on valor infrastructure, it's a 10 digit number starts with 2txn_typestringrequiredDefaults to add_subscriptionTxn type should be add_subscriptionamountstringrequiredDefaults to 10Transaction amount - Maximum amount $99,999.99 (Ex: 0.1 to 99,999.99). A request should not be sent when the amount is 0. The amount must be greater than zerosurchargeAmountstringrequiredDefaults to 1Additional surcharge fee amount to be applied to the transaction. Must be provided as a currency amount in USD (e.g., 10.00).taxstringDefaults to 0Tax amount to be applied to the transaction. Must be provided as a currency amount in USD (e.g., 10.00).payment_infoobjectrequiredProvide any one of the following payment methods: vault_id with payment_id, card details, or a token.payment_info objectsurchargeIndicatorstringrequiredDefaults to 0Set 0 for transactions processed through a traditional MID with no custom fee. Set 1 for transactions processed through a cash discounting MID with a custom fee.recurring_typestringrequiredDefaults to 2Set the recurring type. Recurring TypeOptionsWeekly0Bi-Weekly1Monthly2Quarterly3Annually4Daily5Run at6is_validate_cardstringrequiredDefaults to 0Set 1 for card validation only without charging. Set 0 to process the payment for the current billing cycle.card_holder_namestringName of the cardholder. Must contain alphabetic characters only and have a maximum length of 25 characters.descriptorstringDefaults to TEST DESCRIPTORTransaction descriptor. Must contain a maximum of 25 characters.invoice_nostringDefaults to 12345678Invoice number field must contain a maximum of 12 characters and may include only alphanumeric characters. < and > are not allowed.billing_customer_namestringrequiredDefaults to John DoeCustomer Name - Alphabet (Max length of max 25 chars)billing_street_nostringDefaults to 3636Street number - Number with hyphen (Ex: 1-95)billing_street_namestringDefaults to 33rd streetStreet name - Alphanumeric (Length of 50 chars)billing_unitstringDefaults to 206Street unit (Ex. block, apartment) - Max length of 25 charsbilling_citystringDefaults to ASTORIACity should be allowed max 50 chars of string (Ex: New York, San Francisco)billing_statestringDefaults to NYState 2 chars of capital (Ex: New York - NY, California - CA)billing_zipstringrequiredDefaults to 11106Zip code should be 5 digits (Numeric - Ex: 10001, 90002)shipping_customer_namestringrequiredDefaults to John DoeShipping customer name - Alphabet (Max length of 25 chars)shipping_street_nostringDefaults to 3636Street number - Number with hyphen (Ex: 1-95)shipping_street_namestringDefaults to 33rd streetStreet name - Alphanumeric (Length of 50 chars)shipping_unitstringDefaults to 206Street unit (Ex. block, apartment) - Max length of 25 charsshipping_citystringDefaults to ASTORIACity should be allowed max 50 chars of string (Ex: New York, San Francisco)shipping_statestringDefaults to NYState 2 chars of capital (Ex: New York - NY, California - CA)shipping_zipstringrequiredDefaults to 11106Zip code should be 5 digits (Numeric - Ex: 10001, 90002)product_descriptionstringDefaults to Product 1Description of the product max 50 charssubscription_starts_fromstringrequiredDefaults to 2026-12-25Subscription start payment date accepted expiry YYYYMMDDphonestringCustomer phone number- 10 digit Numeric (Ex: 5247896523)emailstringCustomer email id - Varchar (Ex: [email protected], Max length of 50 chars)charge_untilstringrequiredDefaults to 6Months or Week based on recurring_type. If never expire to pass "never_expired"charge_onstringrequiredDefaults to 25If recurring type 0-Weekly or 1-Bi-Weekly this should be any value from 0 to 6 else if recurring type 2, 3, 4, 5, 6 it accept any value from 1 to 30 Days in monthfailure_notificationstringDefaults to 0Set 1 to enable failure notifications. Set 0 to disable failure notifications.retry_countstringDefaults to 1Specifies the maximum number of retry attempts for recurring payments that fail due to insufficient funds, with a maximum value of 10. If set to 2, the payment will be retried on the next day and the following day.additional_promptsarray of objectsCustom inputs, with a maximum of 25 entries allowed.additional_promptsADD objectpayment_typestringFor installment transactions, the payment type will be sent as 2notification_preferenceobjectSpecifies the payment reminder notification preferences for the subscription, including the notification frequency, reminder timing, and recipient. If notification preferences are configured when creating the subscription, payment reminder emails will be sent to the customer based on the configured settings.notification_preference objectduplicate_transaction_checkint32Set to 1 to enable duplicate transaction checking based on the portal setting. Set to 0 to disable it. For example, By Invoice Number declines transactions with the same invoice number in the same batch.Responses 200200 400400Updated 7 days ago Did this page help you?YesNo