Create invoice BIZUM (POST)

POST

REQUEST

The query is an HTTP POST request where your provided api key will be used as an http header.

It's only available in Spain

END POINT

https://usdc.nonstopay.net/api/btn-create-invoice/get/

HEADERS

API-KEY (Use the api key we’ve sent to you here).

Example

BODY PARAMS

parameter name	Example (type)	Info
email (Mandatory)	[email protected]	The email of your customer
amount (Mandatory)	15.04 or 42	point “.” is a decimal symbol
devise (Mandatory)	USD	This is the currency to be used. Set it to USD. You’ll need to do the exchange on your side to USD if you use another currency
name (Mandatory)	Jones Smith
country (Mandatory)	SP (Spain)	Your customer’s billing 2-char country code (ISO 3166-1, alpha-2)
city (Mandatory)	San Francisco
address1 (Mandatory)	1000 Lombard St
success_url (optional)	https://usdc.nonstopay.net/service/pay/success/	After successful payment.. we will redirect the payment page to the page of this URL
cancel_url (optional)	https://usdc.nonstopay.net/service/pay/cancel/	After canceled payment. we will redirect the payment page to the page of this URL
failure_url (optional)	String | null	After failed or decline payment.. we will redirect the payment page to the page of this URL
callbackJson (optional)	Data type : json Eg : {txId : qktr12eqzg, status : sfrt}	Merchant Data. After successful or canceled payment. we send it to you through the callback url.
pay_mode (optional)	bizum	To be completed only with the agreement of technical support

---

RESPONSE

Our service will return a JSON object.

For Errors :

• 50001 : API-KEY required

• 50002 : email required

• 50003 : amount required

• 50004 : devise required

• 50005 : invalid email address

• 50006 : this API-KEY can not use this API from this IP address

• 50007 : invalid API-KEY

• 50008 : You cannot create a sale because your wallet is being validated and activated.You will receive a confirmation email as soon as the treatment process is completed.While waiting for the final activation, you can still change it from https://usdc.nonstopay.net/client/profile the profile page

• 50009 : invalid devise

• 50010 : No IP is linked to your account. Please enter them in your profile page and API block

• 50011 : Your amount is ABOVE the allowed maximum amount

• 50012 : Your amount is BELOW the allowed minimum amount

Example :

{ “errorCode”: 50003, “errorMessage” : “amount required” }

Success Response :

• 0 :

  • - redirectUrl : URL_TO_PAY

    Use this url if you plan an automated redirection and with S2S direct to valid 3D secure

    - html :

    Use this to integrate as an html link on your page. It does not exists in S2S direct

    With S2S direct integration we also send :

    - status : Transaction Status

    - ID : Transation ID

Example :

{
 “errorCode”: 0,
 “redirectUrl”:
“https://usdc.nonstopay.net/widget/sale/create/?token=cyR0YnNOeG99MTE3WW9ne
C56IFc6Q28gR1BHdG83W3FDMzhlfi1WKmpNSUlPfSNTfVh2fTxaUnpES3omZWYqJCRwf3t4fyg%
2BMX90aWt0cWFVdG5pYWo7cXV8MSYmcmZ6dGNhPyInPyFsbXB8YX8zKSg2MSc3ZHVldGp0Z2pnZ
llxc250MTBqZmd5fA%3D%3D”,
 “html”:“<a
href='https://usdc.nonstopay.net/widget/sale/create/?token=cyR0YnNOeG99MTE3
WW9neC56IFc6Q28gR1BHdG83W3FDMzhlfi1WKmpNSUlPfSNTfVh2fTxaUnpES3omZWYqJCRwf3t
4fyg%2BMX90aWt0cWFVdG5pYWo7cXV8MSYmcmZ6dGNhPyInPyFsbXB8YX8zKSg2MSc3ZHVldGp0
Z2pnZllxc250MTBqZmd5fA%3D%3D'></a>”
}