Remove Postal Code Requirement
Remove the postal code requirement from In-App Payments SDK card entry form.
Important
If the country code for the targeted location is in the US
, CA
, or GB
, you must
not remove the postal code requirement. Doing so will result in all credit card
transactions being declined.
The postal code requirement can be removed for all other countries.
Process overview
Before you start
You have integrated the In-App Payments SDK into your iOS or Android application.
Your application can get the location country code of the merchant who is taking the payment. This must be done by your server backend using the Locations API, since payment will be taken on the customer's mobile device.
Your application is based in a country that does not require the postal code for processing payments.
Step 1: Get the location country of the merchant
Your mobile application will need to make a request to your server backend to
get the correct location and location country. To be valid, the target location
must have ACTIVE
status, CREDIT_CARD_PROCESSING
enabled, and the location.country
field MUST NOT BE any of the following: US
, CA
, or GB
.
Follow the steps in the Search for Locations to find the appropriate location.
In the CardEntry.startCardEntryActivity
method, set the collectPostalCode
parameter to false.
public class CheckoutActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.checkout_activity);
//Find the add card button and set a click listener that starts the CardEntry activity
findViewById(R.id.addCardButton).setOnClickListener(v -> {
//Start the In-App Payments CardEntry activity
CardEntry.startCardEntryActivity(CheckoutActivity.this, false);
});
}
}