BitPay

Payment Method String bitpay
Available Countries DE, NL, IT, BE, GB, GR, ES, EE, CY, FI, FR, IE, LT, LU, MT, PT, SI, SK, US, MC, AU, CZ, AT, LV, HK, MO, SG, MY, PH, CA, MV, AE, AG, AZ, BN, CN, GE, HU, ID, JP, KE, KG, KR, KZ, LI, MG, MN, MX, NP, NZ, PF, PT, SC, SR, TH, TJ, TZ, VN
Available Currencies EUR, GBP, USD
Min Transaction Amount
3 EUR/GBP/USD
Max Transaction Amount
No limit
Supports Refunds
No
Chargebacks
No
Sandbox
Yes (LPM-hosted)

Sample request

HTML POST (HPP)

<form method="POST" action="https://pay.sandbox.realexpayments.com/pay">
<input type="hidden" name="TIMESTAMP" value ="{{ timestamp }}">
<input type="hidden" name="MERCHANT_ID" value ="{{merchantId}}">
<input type="hidden" name="ACCOUNT" value ="internet">
<input type="hidden" name="ORDER_ID" value ="20230202164445-63dbe87dc7626">
<input type="hidden" name="AMOUNT" value ="3800">
<input type="hidden" name="CURRENCY" value ="GBP">
<input type="hidden" name="SHA1HASH" value ="2d763820dac98919ba9233c97e3fe6130ce538e1">
<input type="hidden" name="AUTO_SETTLE_FLAG" value ="1">
<input type="hidden" name="HPP_VERSION" value ="2">
<input type="hidden" name="HPP_CUSTOMER_COUNTRY" value ="GB">
<input type="hidden" name="HPP_CUSTOMER_FIRSTNAME" value ="James">
<input type="hidden" name="HPP_CUSTOMER_LASTNAME" value ="Mason">
<input type="hidden" name="MERCHANT_RESPONSE_URL" value ="https://www.example.com/statusUrl">
<input type="hidden" name="HPP_TX_STATUS_URL" value ="https://www.example.com/statusUrl">
<input type="hidden" name="HPP_ADDRESS_MATCH_INDICATOR" value ="false">
<input type="hidden" name="HPP_BILLING_STREET1" value ="Flat 123">
<input type="hidden" name="HPP_BILLING_CITY" value ="Halifax">
<input type="hidden" name="HPP_BILLING_POSTALCODE" value ="E77 4QJ">
<input type="hidden" name="HPP_BILLING_COUNTRY" value ="826">
<input type="hidden" name="HPP_LANG" value ="EN">
<input type="hidden" name="HPP_CHALLENGE_REQUEST_INDICATOR" value ="NO_PREFERENCE">
<input type="hidden" name="HPP_CUSTOMER_EMAIL" value ="james.mason@example.com">
<input type="hidden" name="COMMENT1" value="Mobile Channel">
<input type="hidden" name="COMMENT2" value="Down Payment">
<input type="hidden" name="CARD_PAYMENT_BUTTON" value="Pay Now">
<input type="submit" value="Click here to Purchase">
</form>

XML

<?xml version='1.0' encoding='UTF-8'?>			
<request type='payment-set' timestamp='{{timestamp}}'>			
	<merchantid>Merchant ID</merchantid>		
	<account>internet</account>		
	<amount currency='GBP'>3800</amount>		
	<autosettle flag='1' />		
	<orderid>N6qsk4kYRZihmPrTXWYS6g</orderid>		
	<paymentmethod>bitpay</paymentmethod>		
	<paymentmethoddetails>		
		<returnurl>https://www.example.com/returnUrl</returnurl>	
		<errorurl>https://www.example.com/errorUrl</errorurl>	
		<statusupdateurl>https://www.example.com/statusUrl</statusupdateurl>	
		<descriptor>Test Transaction</descriptor>	
		<country>GB</country>	
		<accountholdername>James Mason</accountholdername>		
	</paymentmethoddetails>		
	<comments>		
		<comment id='1'>Mobile Channel</comment>	
		<comment id='2'>Down Payment</comment>	
	</comments>		
	<sha1hash>82f3d22c04292f8673bc1e0fb8ecf0c54e38065c</sha1hash>		
</request>			

JSON

{                        
        "account_name": "{{acc_name}}",                
        "type": "SALE",                
        "channel": "CNP",                
        "amount": "3800",                
        "currency": "GBP",                
        "reference": "{{reference}}",                
        "country": "GB",                
        "payment_method": {                
                "entry_mode": "ECOM",        
                "apm": {        
                        "provider": "bitpay"
                }        
        },                
        "notifications": {                
        "return_url": "<Replace with your own endpoints>",                
        "status_url": "<Replace with your own endpoints>"                
        },                
        "payer": {}                
}

 

No additional mandatory or optional fields are required for this payment method.

By following our standard integration article, you can simply configure it on the HPP. For XML API integrations you'll need to pass the correct payment method string in the payment-set request.