Attributes for metadata
invoice_rapid_data object Required
customer_email string Required
The email of your buyer/customer
customer_is_business boolean Required
If the customer is a business or not.
true The customer is a business
false The customer is not a business
customer_country enum Required
Two-letter ISO 3166-1 alpha-2 country code of your buyer/customer, in uppercase. See ISO 3166-1 alpha-2
tax_id_customer nullable string
Your buyer’s TAX ID is required only when your buyer is a registered business entity. It must include only the TAX ID number without the country code (e.g., 12345678912)
tax_amount nullable integer Required
If Stripe Tax is not active, this field must be null. If Stripe Tax is active, this field must be an integer representing the tax amount returned by Stripe Tax. If the tax returned by Stripe Tax is zero, the value should be 0 as an integer. The amount should be expressed in the currency’s minor unit, so pay attention to the difference between zero-decimal and two-decimal currencies. To learn more about these differences and see which currencies fall into each category visit https://docs.stripe.com/currencies#two-decimal
product_id string Required
The unique identifier for the product sold in the transaction
customer_name string Required
Full name of your buyer or customer. If the customer is a business, enter the business name.
customer_address object Required
Must be an object with this structure:
{
"city": "Barcelona",
"country": "ES",
"line1": "Carrer de Mallorca 401",
"line2": "333",
"postal_code": "08013",
"state": "B"
}The keys of customer_address must be these:
- city string Required
The city of your buyer/customer
- country string Required
Two-letter ISO 3166-1 alpha-2 country code of your buyer/customer, in uppercase. See ISO 3166-1 alpha-2
- line1 string Required
The Street address only
- line2 string
The building number only
- postal_code string
The postal code of the address. This field is mandatory for all European Union countries except Ireland (IE). The filed is mandatory also for all states of United States and for United Kingdom.
- state string
The state within the country. This field is mandatory when the country is Spain or the country is United States.
For Spain the state must be one of this: VI, AB, A, AL, O, AV, BA, B, BU, CC, CA, S, CS, CE, CR, CO, CU, GI, GR, GU, SS, H, HU, PM, J, C, LO, GC, LE, L, LU, M, MA, ML, MU, NA, OR, P, PO, SA, TF, SG, SE, SO, T, TE, TO, V, VA, BI, ZA, Z
For United States the state must be one of this: AL, AK, AZ, AR, CA, CO, CT, DE, DC, FL, GA, HI, ID, IL, IN, IA, KS, KY, LA, ME, MD, MA, MI, MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, OH, OK, OR, PA, RI, SC, SD, TN, TX, UT, VT, VA, WA, WV, WI, WY
{
"metadata": {
"invoice_rapid_data": {
"customer_email": "jack.wild@gmail.com",
"customer_is_business": true,
"customer_country": "ES",
"tax_id_customer": "12345678912",
"tax_amount": 30,
"product_id": "prod_NWjs8kKbJWmuuc",
"customer_name": "Jack Wild Limited",
"customer_address": {
"city": "Barcelona",
"country": "ES",
"line1": "Carrer de Mallorca 401",
"line2": "333",
"postal_code": "08013",
"state": "B"
}
}
}
}














